The Hermes Agent kanban board, on your phone

At a glance

Hermes feature

Kanban, a task board shared by all your profiles

What Herald talks to

The bundled kanban dashboard plugin (/api/plugins/kanban)

Updates

Live over the board’s event socket, or every few seconds if that drops

Connection

Your primary connection

Who starts the work

The Hermes dispatcher, which runs inside the gateway

The lanes

Archived cards stay hidden unless you choose Show archived. Running, Scheduled and Review are owned by the bot and its dispatcher, so you can’t drop cards there yourself.

Working with cards

Tap New card to add one: a title, notes in Markdown, an assignee, a priority from Low to Urgent, and a starting lane of Triage, To do or Ready. Advanced options set the workspace (a throwaway Scratch folder, an existing Directory or a git Worktree on the Hermes computer), a model override, skills, a maximum runtime, goal mode and a turn limit. Ready cards start as soon as the dispatcher sees them, if a bot is assigned.

Open a card for its tabs: Comments, which bots read when they pick the card up; Activity; Log, the worker’s output, refreshing while it runs; Files, up to 25 MB each; and Links to parent cards and subtasks. Triage cards offer Specify, where a bot writes a fuller spec, and Decompose, where it splits the card into subtasks. A card in review offers Approve → Done or Request changes, and a running one offers Reclaim or Stop run.

Move cards by dragging them to a lane or the edge of the screen, or swipe a row: right to advance, left for more, hold to move. Mark a card blocked with an optional reason, such as “waiting on API keys”.

Boards, orchestration and the roster

The board menu switches boards, filters by bot, hides empty lanes and opens Boards… to create, rename, export, import, archive or delete a board, or make one current for the Hermes CLI. Exports are saved as a .tar.gz on the Hermes computer.

Orchestration settings choose the Orchestrator bot that specifies and decomposes triage cards, a Default assignee for unassigned Ready cards, and whether to auto-decompose triage cards and auto-promote subtasks. Changes are saved to config.yaml on your Hermes.

On the roster, a badge counts each bot’s cards; long-press a bot and choose Kanban tasks to see only its work. On iPad, Mission Control has a kanban summary.

Open the board

1. Make sure the plugin is there

   The kanban plugin ships with Hermes. If Herald says “Kanban plugin not found on this Hermes”, run hermes update, and check that dashboard.plugins.kanban.enabled isn’t set to false.

2. Keep the gateway running

   The dispatcher that starts Ready cards runs inside the Hermes gateway and checks every 60 seconds by default. See gateway not running.

3. Open Kanban board

   It is in the More menu on Herald’s home screen.

4. Create a card and assign a bot

   Start it in Ready to have the bot pick it up, or in Triage to shape it first.

Limits

• The board follows your primary connection. Change it with Make primary in Settings › Connections.
• Herald can’t start a run itself. Only the dispatcher can, so move the card to Ready and assign a bot.
• Files over 25 MB can’t be attached to a card.
• Importing needs a board export that is already on the Hermes computer.