harnsy

Inbox: client mail and chats arrive in your project, and you decide what reaches your AI team

Requests reach you in three places at once: your mailbox, a group chat, a form on your site. Your AI team sits in a fourth place and sees none of them, until you copy a letter over and explain what to do with it.

4 min readPavel Buchnev
In this article
  1. What you get
  2. An example
  3. How it works
  4. What an agent sees, and what it does not
  5. What needs harnsy Max
  6. When

harnsy 0.11 gives every project an «Inbox»: one place where these messages arrive, and rules that say which of them go to your AI team and as what.

What you get

  • One list of what came in. Mail from a mailbox, messages from a Telegram group or a Discord channel, events from a webhook: each source is a feed, and all of them land in the project’s Inbox.
  • Rules you write. A rule says: if a message is like this, then do that, at once or in a batch. Without a rule nothing reaches an agent.
  • Reply drafts that wait for you. An agent can draft the answer to a letter. It goes out only after your yes.
  1. Mailbox (read-only)
  2. Inboxon your computer
  3. Your rule
  4. Your AI team
  5. Reply draft
  6. Your «Send»
How a letter reaches your AI team, and how the answer goes back.

An example

Say you work with clients by e-mail: orders, questions, «can we move Thursday». You connect that mailbox to your project. One rule turns every letter from a client’s domain into a task for your assistant role. Another gathers the newsletters and receipts into one message to your AI lead once a day. For the questions you get most often, a third rule asks the assistant for a reply draft, and you read it before it goes.

Your own mailbox stays as it was. harnsy opens it read-only: by design it does not delete a letter, move one or mark one as read.

How it works

  1. Open the Inbox of your project. It has two tabs: «Messages», the list of what came in, and «Feeds», the sources.

  2. Connect the mailbox. Press «Source» and choose «Mail · Max». Enter the address and an app password: a separate password your mail provider gives you for programs, not the mailbox’s own one. Choose where to start, «From now» or «Last 7 days», press «Check» to see that the login works, then «Connect».

  3. Look at what arrives. From this moment letters are stored in the Inbox, on your computer. No agent has seen one yet: a new mailbox has no rule.

    Example

    Today

    • Maria Keller09:12Order for the June workshopHello, we would like to book twelve seats for…→ #231
    • Tomas Lind09:40Can we move Thursday?Something came up on my side. Would Friday at ten…Draft · #233
    • Priya Nair10:05Invoice questionThe invoice shows two items, but we ordered…→ #232
    • Weekly Newsletter10:30Your weekly digestFive stories picked for you this week…no rule matched
    • Parcel Service11:02Your parcel is on its wayTrack your delivery with the number below…no rule matched
    How the Inbox looks: what came in, and what each message turned into.
  4. Add a rule. On the tab «Feeds», open the mailbox’s feed and press «Rule». A rule has three parts.

    • If: who writes (an address or a whole domain), words in the text, or whether the letter has attachments. Leave it empty and the rule takes everything.
    • Then: «Item for a role», «Item in the lead’s backlog», «Message to a role», «Message to the lead» or «Reply draft».
    • When: «At once», on every matching message, or in a batch, «Hourly» or «Daily».
    New ruleExample
    If

    Who writes

    Address or domain@client.example
    Words in the text

    With attachments

    Then
    ActionItem for a role
    RoleAssistant
    When
    At onceHourlyDaily
    A rule: if, then, when.
  5. Answer through drafts. With «Reply draft» a role writes the answer and the Inbox shows «A reply draft waits for you». You read it and press «Send», write the answer in your own words instead, or decline. harnsy is built to send only a reply you sent this way, from the same mailbox. A reply draft needs a rule set to «At once».

  6. Add other sources the same way. For a Telegram group, press «Connect a bot» and choose what to collect: only the messages addressed to the bot, or all of them (tell the people in the group: the Inbox then keeps what everyone writes). Even when the Inbox keeps every message of the group, no agent gets the ones that were not addressed to the bot unless a rule of yours hands them over.

What an agent sees, and what it does not

An agent is not given your Inbox. It gets what a rule hands it: the one letter that became its task, or the batch that became one message. The rest stays in the list for you.

A letter a rule hands to an agent goes to the AI program that agent runs on, under your own plan with its maker, like any other text you give your agents. Where does my data go?

Two numbers worth knowing. A feed takes in up to 2000 messages a day; past that it stops reading until midnight and goes on the next day. And the Inbox keeps a letter for 30 days unless you set another term (a group chat collected in full: 7 days); your mailbox itself is not touched.

What needs harnsy Max

The mailbox needs harnsy Max: reading mail into the Inbox and sending the replies you approve. A Telegram or Discord source needs a bot, and bots are part of harnsy Max.

When

See also: Letters: your AI team sends e-mail, and the first one to every address waits for your yes — letters your agents send by a template, not as a reply.

Telegram and Discord are names of their owners’ products; harnsy is not affiliated with or endorsed by them.

Join the people who run it

Ask questions, see what others built.

Join the Discord
site-3flead · Claude Codeliveview only
❯ Plan #42 with the team.

Waiting for the breakdown from analyst-7a…

from analyst-7a through harnsy❯ #42 broken down: three acceptance criteria, including a retry after 24 h.

I’ll hand #42 to site-9a.

❯