agents-dash-list

Paseo plugin that adds an Agents dash entry to the app sidebar, next to "New workspace", "History" and "Schedules". It lists every workspace on every host you have configured and the agents inside it, on one screen, grouped by what needs your attention.

Groups

Workspaces are sorted into exactly one group, in this order, and within a group by last activity (newest first):

Only non-empty groups are shown. Each group is a bordered section with a bold heading; pressing the heading folds the group shut or open. The Unread and Approved headings also carry an Archive all button (see below).

Hosts

Every host configured in Paseo is read at once and the workspaces are merged into a single feed, so a group like "Waiting for you" holds whatever is waiting anywhere. Each row names its host on the meta line, opens on that host when pressed, and is archived through that host's own connection.

When more than one host is configured the header holds a Host picker listing them all with workspace counts; disconnected hosts are listed as name (offline). Pick any number of hosts to narrow the feed. A host that is disconnected or fails to answer is reported in a notice above the feed while the other hosts keep working; only when none of the selected hosts answers does the whole screen turn into an error with a Retry.

On a Paseo older than 0.8 the app exposes no host list, and the dash shows the host it was opened on exactly as before.

Project filter

The header holds a Project picker listing every project that has a workspace on a visible host, with workspace counts. Pick any number of projects to show only their workspaces; the count in the header then reads 12 of 61 workspaces, and "All" in the picker (or "Clear filters" on the empty screen) clears the choice.

Remembered settings

The host choice, the project choice and the folded groups are remembered between opens and across app restarts. They are stored per daemon by the plugin's server entry under $PASEO_HOME/plugin-data/agents-dash-list/settings.json, so every client of that daemon opens the dash the way it was left.

Row anatomy

Each workspace is one row:

1. Main line — the project icon, the workspace name, the time of last activity, and (for the groups that have them) quick-action buttons.
2. Meta line — project name, branch, host, and, when the workspace has a pull request: its state, checks, and review decision. Workspace labels render last, as the same colored chips the built-in sidebar workspace list uses.
3. Agents line — a row of small pills, one per agent, each showing a shortened agent name and an icon for that agent's own activity (waiting, unread, working, failing, idle). Pills are sorted by activity, then by last activity.

Pressing the main line navigates to the workspace's first agent (or the workspace itself when it has no agents); pressing an agent pill navigates straight to that agent. Pressing the pull request item on the meta line opens it in the browser instead of navigating.

Quick actions

Quick actions appear on the groups a glance can settle; the groups with live activity (Waiting, In progress, Failing) are navigate-only:

• Unread — Archive.
• Approved — Archive.
• Idle — Mark as unread, Archive.
• Merged or closed — Archive.

Archiving a workspace that has uncommitted changes or unpushed commits asks for confirmation first, listing what would be left behind.

The Unread and Approved headings also offer Archive all, which archives every workspace currently in that group. It always asks first: the dialog says how many workspaces go and lists the ones that still hold uncommitted changes or unpushed commits. Workspaces are archived one after another and a toast reports the outcome, naming any that failed.

Unread marks

"Mark as unread" is a marker owned by this plugin, not by Paseo itself — the built-in sidebar has no notion of it. The mark clears automatically the moment the workspace is opened from the dash, or the moment the workspace produces newer activity than the mark (a finished run, a new pull request check, and so on), whichever comes first. Marks are stored per daemon under $PASEO_HOME/plugin-data/agents-dash-list/unread.json and pruned after 90 days, or when their workspace no longer exists and the dash was able to list every host's whole workspace directory (a directory too large to enumerate, or a host that did not answer, is never treated as a census, so no mark is dropped by mistake). The store is the one belonging to the host the dash was opened on, and it holds marks for workspaces on the other hosts too.

How it works

• The client keeps one live mirror per host: useHosts() lists the configured hosts and getPaseoClient(serverId) borrows each one's API, and the mirror subscribes to that host's workspace and agent directories (the same list + subscribe streams the rest of the app uses). Mirrors are reconciled as hosts connect and disconnect, so one host dropping does not re-seed the others. The grouped model is recomputed locally whenever any stream changes or an unread mark is set or cleared; each host is indexed separately, since agents and their parents never cross hosts.
• The server side exposes small RPCs the client can't do itself because they need the daemon's filesystem: reading the workspace-label color catalog, resolving project icons (custom upload or automatic discovery), and reading/writing this plugin's own unread marks and viewing settings — all under $PASEO_HOME on the daemon machine (resolved the way the daemon resolves it, including a leading ~).
• Project icons in SVG or ICO form only render on web and desktop. React Native cannot decode those containers on iOS or Android, and a plugin cannot bring its own SVG renderer, so on phones and tablets those projects show the same lettered color square Paseo falls back to.
• Plugin RPC has no cross-host form, so the server side only ever runs on the host the dash was opened on. Project icons are therefore resolved for that host's projects alone — rows from other hosts fall back to the lettered color square — while the label color catalog, unread marks and viewing settings from that one host apply to the whole feed.

Limitations

• The dash only shows a workspace's root agents as pills; subagents running inside their parent's workspace contribute to that workspace's activity but do not get their own pill.
• Pull request state, checks, and review decision are only as fresh as what Paseo's daemon has already synced from the forge; the plugin does not poll the forge itself.
• Unread marks and viewing settings live on the daemon the dash was opened on. Opening the dash from a different host shows that host's marks and settings instead.
• Workspaces on other hosts show the lettered color square rather than their project icon, and their workspace labels are colored from the opening host's catalog when the names match.

Install

paseo plugin add panrafal/paseo-plugins:agents-dash-list

From a checkout:

npm install            # from the monorepo root
npm run typecheck
paseo plugin install /absolute/path/to/paseo-plugins/agents-dash-list
paseo plugin ls        # expect "running"

After editing:

npm run typecheck
paseo plugin reload agents-dash-list
paseo plugin logs agents-dash-list