Guide
Hermes Agent Kanban: The Native Multi-Agent Task Board
Kanban is a built-in Hermes feature, not a skill you have to write. It's a SQLite-backed board where one agent dispatches tasks and other agent profiles claim and run them — with a real drag-and-drop dashboard tab and completion notifications pushed straight to Telegram, Discord, or Slack.
What the Kanban Board Does
Each board is a SQLite database (kanban.db) of work items. A task has a title, body, assignee, priority, and a status that moves through the columns:
todo→ready→running→done- plus
scheduled,blocked, andarchived
The point is multi-agent collaboration: a dispatcher agent files tasks, and worker profiles spawned with hermes -p <name> join the same board and claim work. A gateway-side watcher loop polls the board and sends you a message when a task completes, blocks, or crashes.
Use It from the CLI
# Open the kanban subcommand
hermes kanban
# Add a task to the board
hermes kanban add "Summarize this week's GitHub issues" --priority high
# List tasks and their status
hermes kanban list
# A worker profile joins the same board and claims work
hermes -p worker1 kanban claimInside a chat, the /kanban slash command surfaces the same board so you can manage tasks conversationally without leaving Telegram or Discord.
Use It from the Dashboard
Hermes ships a built-in Kanban tab in the web UI. You can drag cards across columns, read the comment thread on each task, and see which profile is currently running which card — a live view of every agent on the board. No extra install: the tab is part of the gateway dashboard.
kanban/boards/<slug>/kanban.db, so you can keep separate boards for separate workstreams.Completion Notifications
The gateway watches every board and emits terminal events. When a worker finishes (or a task blocks or crashes), Hermes pushes a notification over whichever channel you have connected — Telegram, Discord, or Slack — so you don't have to babysit the board.
Multi-Agent Workflow Example
- Your main agent files three research tasks on the board.
- You start two worker profiles:
hermes -p worker1andhermes -p worker2. - Each worker claims a task, runs it in its own isolated profile, and marks it
done. - The gateway DMs you a summary as each card completes.
Because each worker is a real profilewith its own memory and skills, the runs stay isolated — and Kanban enforces per-profile task caps so one worker can't starve the others.
Looking for the Workflow Walkthrough?
This guide covers setup. If you want the “why” — running an AI project board entirely from chat — see the use case: Hermes Kanban for AI project management.
What's Next?
- Hermes Agent Profiles — the worker profiles Kanban uses
- Hermes Agent + Telegram — where notifications land
- Hermes Agent Skills — orchestrator and worker skills
- Hermes Kanban use case — the project-management scenario