Your first board

You know these commands. The order is what matters, and two steps are where boards get stuck.

Not on this phone These commands run on the computer where Hermes is installed. Copy them here, then walk over to it.

0/6 steps

Step 0 · You know what a tick does

Ticks itself once you have stepped the simulated board at least once. Opening the screen does not count, and nothing here is pre-filled to flatter you.

Step 1 · Create the board file

hermes kanban init

Creates the board's file at ~/.hermes/kanban.db. Optional, because the first kanban command you run does it for you.

Step 2 · Open the Kanban tab

hermes dashboard

Serves http://127.0.0.1:9119. Click Kanban in the left nav. Six empty columns.

Step 3 · Create one card

hermes kanban create "summarise my inbox" --assignee researcher

Use a profile name that exists. hermes profile list shows yours. A card addressed to a name that does not exist never runs, and nothing tells you why.

The + button at the top of any dashboard column does the same thing.

Step 4 · Give the dispatcher a home

hermes gateway start

The dispatcher lives inside the gateway and sweeps every 60 seconds. No gateway, no movement.

Step 5 · Step it by hand

Press Nudge dispatcher instead of waiting. The card goes Ready, In progress, Done. Open it to read what the agent wrote.

Nothing moved? Read When it breaks. Five causes, all quick.

Take it to your computer

All four commands in one block, in order.

hermes kanban init
hermes dashboard
hermes kanban create "summarise my inbox" --assignee researcher
hermes gateway start

Your first board

The steps

Take it to your computer