Omniscio

Inbox agents

An agent that owns your Needs-You inbox. It checks everything waiting every five minutes, settles or routes what it can so the agents blocked on a reply keep working while you are away, and reports back in a short digest on a cadence you choose. It learns your sorting rules as you correct it and keeps them where you can read and change them.

On this page

What it is

An inbox agent is one session whose job is your Needs-You list. Instead of you opening the inbox and deciding what each waiting item needs, the agent does that: it reads everything waiting, decides what each item is, does what it can itself, and brings you only the things that genuinely need a person.

Two clocks keep it useful. It runs a fast pass every five minutes, and its job there is to answer the agents that are blocked waiting on a reply — a session sitting on a question is a session not working, and on a cloud machine it is money going out. Then it reports back to you in a short digest on a cadence you choose, 30 or 60 minutes. The fast passes are silent; only the digest reaches you.

It also learns. The first time it runs it works through your real inbox with you one item at a time, asks what you would do, and records the rules it deduces. Those rules are yours, they are stored in the app, and they outrank the agent's own defaults.

Why it exists

An inbox fills with finished agents, waiting questions, alerts and decisions, and deciding what each one needs is real work that repeats every few minutes. Most of it is not a decision only you can make — it is routing something to its owner, archiving something that is done, or answering an agent that is blocked. An inbox agent does that part, so what is left in your inbox is what actually needs you.

Where to find it

  • Settings → Inbox agents. The panel holds one control — Start an inbox agent — and the list of rules your agent follows, which you can read, add to, and remove. Removing one asks you to confirm first, and the confirm quotes the rule so you can see exactly which one goes.
  • Default: off. The feature is in development, so it is revealed from Settings → Lab (Inbox agents). Until it is on, the panel renders nothing and no agent can be started.
  • Nothing runs by itself. Starting an agent is a deliberate click; there is no default that creates one.

How it behaves

  • Starting is one action. Pressing Start an inbox agent starts it as your Inbox mission. It arms its own five-minute pass and its digest, and then runs the interview that learns your rules. You do not configure any of that by hand.
  • Starting twice is still one agent. If an agent is already running, Start hands you the one you have instead of making a second — two agents on one inbox would double every decision.
  • A started agent that has not checked in yet says so. The agent arms its passes itself, which happens a moment after it starts. Until it does, the panel says it has started but not checked in. If that message stays, the agent did not finish setting itself up, and that is worth knowing rather than having it look installed and do nothing.
  • Your rules are the user's own document. The panel is the place to add one in your own words. The interview adds the ones it learns; every rule records whether it came from you or from the agent.
  • Only real questions reach you. A pass the agent ran on its own never becomes a notification. You hear from it through the digest, through a card when it has something to ask, and when it answers a message you sent it.
  • Its questions arrive written out, never as a pointer. When it needs an answer it puts the question in the message you are reading — numbered, with lettered options — rather than telling you to go and answer something somewhere else. Anything it wrote above its final message, or on another card, is not something you can see, so it never sends you to look there.
  • Other people's cards are left to you. A plan, contract or decision card raised by another overseer belongs to you and that overseer. The agent does not re-ask it, does not copy its question into your digest, and does not answer it for you. If one has sat unanswered for a long time — about four hours of your day by default — it sends one short reminder naming the card. That threshold is a rule in the panel; change the number or delete the rule to stop the reminder.
  • What it will not do on its own. It never archives a crew member, never archives a finished audit, and never stops a session, pushes, deploys or changes your settings without your explicit yes for that action. It asks before opening up your paused sessions.
  • If the agent stops, you are told. An agent that dies looks exactly like an agent with nothing to say, so the app watches for it: when nothing is screening your inbox and the gate is still switched on, you get one card saying the agent has stopped, with a Start it again button that does the same thing the panel's Start does. It takes about ten minutes — two of the agent's own passes — before the app calls it an outage, so an agent that is merely restarting is not reported, and a card clears itself as soon as an agent is back at the gate. Until then your items still reach you; they simply arrive without being checked first. With the feature switched off in Settings → Lab no agent is expected at all, so this card is never raised and one left open clears — its only button is a Start the app would refuse.
  • Stopping it is archiving the session. There is no separate stop switch to learn; the agent is a session, and archiving it is how every other session is stopped. Your rules stay where they are, so the next agent starts already knowing them.

What reaches you, and what does not

The dispatch rules an inbox agent's digest follows:

  • Only what it cleared. The digest covers the items the agent took care of or archived for you — a record of work done, not a status board. Things still in your inbox are yours to get to, and are not reported on.
  • No waiting-on-you lines. A report never carries them.
  • One sentence per bullet, with the detail nested underneath. This is the hard standard for every inbox overseer.
  • A session that cleared itself out of the list still owes you its outcome. A self-archived session's result belongs in the digest, or you would never learn it finished. A session with a likely next action (a question, a recommended action other than "None", a push/deploy/restart/sign-in) stays in the list instead.
  • Each self-archive is judged on its merits — there is no setting for it. Self-archiving is often right and sometimes wrong, and the difference is decided case by case.
  • "Recommended action: None" is not proof the work is finished. The final message is read in full and judged on its own merits.
  • Quiet hours. Digests are suppressed entirely inside the window, not delayed, and nothing is posted when it ends unless the night had an exception. The setting is Quiet hours, under Overseers hub → Fleet settings → Quiet hours, on by default across 22:15–08:15.
  • An item another owner has taken leaves the list once that owner confirms, with a digest line naming who has it.
  • Updates never close with a nothing-to-report line. Filler such as "Nothing needed from you" is itself the intrusion: when there is nothing to ask, the update says nothing about it.
  • The agent knows your other overseers and what each one is for. It reads the live roster on every pass and routes an item to the owner whose mission covers it, never to whoever is nearest. The roster and each one-line mission come from GET /overseer/hub; the owner's own brief for a given overseer is that session's firstOperatorMessage from GET /sessions?q=<name>. Note that GET /sessions/digest is not one of these — a session's own token reaches it only at scope: "metadata" (no message bodies), so a client reading firstOperatorMessage out of it gets nothing and would report "no overseers" on an empty answer; pass the global token or read the roster from /sessions instead.
  • It works in your project and nowhere else. Only items whose project is the one the agent was started for are touched; another project's session or card, and any card with no project, is left alone and never judged. It also never investigates or routes machine infrastructure — drives, the test fleet, the git store, the rebase lanes — and never puts machine health in an update.
  • One row per ask. A question appears in the routed update and never also as a card, so there is nothing to reconcile before answering.
  • The digest is bullets and nothing else — no section headings, no group bullets, one short sentence per bullet, and at most ONE level nested underneath.
  • While it runs it screens your inbox. Starting one switches the gate on (inboxOverseerGateEnabled, addressed at the agent through inboxOverseerGateSlot) so new sessions and alert cards are held for a moment. The agent reads GET /overseer/gate/held each pass and ends every hold itself — POST /overseer/gate/release for what you should see, POST /overseer/gate/dispose for what it handled, batched up to 50 through POST /overseer/gate/act. Unsure means release.
  • The gate cannot strand anything on its own. Its address is whoever leads the Inbox mission now, so a mission with no live lead has no address — a stopped agent holds nothing, and an item already held is released on its own deadline.
  • missions-hub.md — an inbox agent runs as a mission, and its five-minute pass and its digest are its own wake schedules.
  • overseers.md — the always-on assistant an inbox agent sits beside.
  • inbox-overview.md — the inbox an agent reads, and what lands in it.

Last verified 2026-11-19