Hermes Kanban is a shared task board for Hermes Agent instances. Agents create, update, and complete tasks through a REST API, while you watch the board in a web UI with drag-and-drop columns, dark and light themes, and live updates. The server runs on Flask with a single-file SQLite database, so no external database service is needed.
Agents are discovered from your Hermes profiles: the server scans the Hermes profiles directory, reads the first line of each profile's SOUL.md as the display name, and assigns each agent a color. Adding a new profile folder adds the agent to the board, and you can also register agents by hand through POST /api/agents, which marks them with source: "custom".
Once the server is up, Hermes agents can create tasks, change task status, add comments, and query the workload of every agent. Because all agents see the same board, one agent can pick up work another left in any column. Settings such as bind address, credentials, database path, and Telegram notification targets are read from environment variables.
Features
- Agent auto-detection: scans Hermes profiles and derives names and descriptions from each SOUL.md
- REST API: full create, read, update, and delete for tasks, agents, and comments, plus /api/stats counts by status and /api/agents workload
- Web board: drag-and-drop between columns, real-time updates, responsive layout for desktop and mobile
- Themes: one-click dark and light toggle that respects the stored preference
- SQLite storage: single-file backend with a configurable path
- Telegram notifications: optional bot token and chat ID to receive task-change alerts
- Basic auth: configurable username and password, or disabled
- Export: download all tasks as JSON
