← Plugins

Agent inbox

One inbox for the top-level agents on every connected host, with Settle and Snooze.

$ paseo plugin add wangfh5/agent-inbox
Report a bug
wangfh5Orchestration6installs08bc49c9cd51Source
Agent inbox screenshot 1Agent inbox screenshot 2Agent inbox screenshot 3Agent inbox screenshot 4

Agent inbox lists the top-level agents from every host you are connected to in one place, sorted by what needs you. It adds an Agent inbox screen and a sidebar row whose badge counts the agents that need attention. Clicking an agent opens its normal Paseo chat; replies, permission approvals and everything else happen there.

Agents sit in four sections and move between them as their state changes. Needs attention holds agents with a pending permission request, an error, or a finished turn you have not settled. Reading a chat does not settle it, so nothing slips out of the queue just because you opened it. Working holds running agents. Snoozed and Settled hold agents you have put aside, and Settled also holds idle agents with nothing pending. On wide screens the sections form two columns, attention above Working on the left and Snoozed above Settled on the right; on narrow screens and phones they stack in one column. Search matches title, host, project, path and model.

Subagents are hidden by default, from the list, the counts and the badge alike. An agent counts as a subagent when its own Paseo metadata names a parent, so children of an offline, archived or remote parent stay hidden too, and a detached agent shows up again as top level. Titles are never used to guess. Agents whose workspace was archived are left out, as in Paseo's own sidebar. A Show subagents setting lists them nested under their parents.

Settle is always a deliberate action meaning you have handled an agent's current turn: it moves to Settled until something new happens, such as a new permission request, an error, or a new prompt from you. Snooze hides it until a time you pick (in 1 or 3 hours, this evening, tomorrow, next week, or a custom date, time or duration) and brings it back early on a new permission request, error or prompt. Refreshes, reconnects, renames and reading the chat do not bring a settled or snoozed agent back, and an expired snooze returns a turn you started to Needs attention even if you read the chat meanwhile. Turns you did not start, from heartbeats, schedules or other agents, never end a settle or snooze. For an agent that runs on heartbeats, snooze it: routine replies stay in Snoozed, errors and permission requests still surface at once, and after the snooze ends each new heartbeat reply needs attention again. Agents that were already idle when the inbox first ran start out settled. Both can be undone.

The plugin reads agent and workspace lists through your existing host connections and never changes your agents: it does not rename, archive, stop, prompt or mark anything read. Settle and Snooze are kept in a settings document on the host where the plugin is installed, shared by every client of that host. Install it on one host that your clients connect to; each additional installation keeps its own separate Settle and Snooze state. A host that is offline or fails to load is reported and skipped, and its agents' Settle and Snooze state is kept; a record that no client has seen for 30 days is removed. Each host's list is read up to 2,000 agents, newest first; beyond that the badge shows a lower bound such as "5+".

Requires Paseo 0.14 or later. Forked from Agent monitor by omercnet.