← Home

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:

  • todoreadyrunningdone
  • plus scheduled, blocked, and archived

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 claim

Inside 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.

Multiple boards are supported — each project gets its own 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

  1. Your main agent files three research tasks on the board.
  2. You start two worker profiles: hermes -p worker1 and hermes -p worker2.
  3. Each worker claims a task, runs it in its own isolated profile, and marks it done.
  4. 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?

Deploy Hermes with Kanban

Run a multi-agent task board in 30 seconds — dispatcher, workers, and completion notifications included.

Deploy Hermes