NuMust · Educational Series

Hermes Kanban: The AI-Native Task Board That Works While You Sleep

Kanban evolved from sticky notes on a whiteboard to a durable SQLite-backed multi-agent work queue. This guide teaches you what it is, why it matters, and how to put it to work with four real project blueprints.

Interactive demo included 4 project blueprints For developers, founders & AI enthusiasts

What is Kanban, Actually?

Kanban is a workflow visualization system. The word means "signboard" in Japanese — it originated at Toyota factories in the 1940s as a way to signal when more parts needed to be produced. Workers would move a physical card from one bin to another, and that card was the signal: make more of this part.

The core idea is simple but powerful: make work visible. Instead of a to-do list where everything blends together, Kanban splits work into columns that represent stages. You can see at a glance what's being worked on, what's waiting, and what's done.

The Six Columns

Triage

New tasks that need to be fleshed out before they can be worked on. A one-liner idea waiting to become a real spec.

Todo

Tasks with a clear spec, but waiting on a dependency (a parent task) to finish first before they can start.

Ready

Tasks that are fully specified and unblocked — ready for someone (or something) to pick them up and start working.

Running

Work that is actively being done right now. In Hermes, this means an agent process has been spawned and is executing.

Blocked

Work that hit a wall and needs a decision, input, or review before it can continue. Human-in-the-loop checkpoint.

Done

Completed work with a structured handoff — summary, metadata, and audit trail preserved forever in the database.

Why People Use It

Before AI Agents: The Manual Era

For 80 years, Kanban was a human-only system. The board was the tool, but humans did every single piece of work. A developer moved a card from "Todo" to "In Progress" — then wrote the code. A reviewer moved it to "Review" — then reviewed it. Every column required a person's hands and brain.

1940s

Tyota Production System

Physical cards on a factory floor. A card moves from bin A to bin B → workers produce more parts. The signal IS the system. No software, no dashboards — just paper and discipline.

2007

Dominica DeGrandis adapts Kanban to software

Digital boards replace physical walls. Trello, Jira, Asana, GitHub Projects. Columns became lists. Cards became tickets. But humans still did every single task — the board was a passive tracking tool, not an active worker.

2010s

SaaS Kanban explosion

Dozens of Kanban tools compete on UI polish, integrations, and collaboration features. But the fundamental model is unchanged: the board tracks work, humans do work. Automation is limited to moving cards on a trigger ("when PR merged → move to Done"). The board never does the work itself.

2025-26

AI agents enter the picture

Tools like Claude Code, Codex, and Hermes Agent introduce autonomous agents that can actually do work, not just track it. But most agent tools are stateless — they run, produce output, and forget. The board and the agent are separate systems. You still manually copy agent output back into your project.

The Core Limitation of Traditional Kanban

Every traditional Kanban tool shares one fundamental constraint: the board is passive. It tracks work, but it never does work. Every card requires a human to pick it up, do the task, and move it forward. If your team is sleeping, work stops. If someone quits, their cards sit frozen until someone else picks them up.

In the AI agent era, this constraint is no longer necessary. The agent can be the worker — but only if the board and the agent are the same system.

Hermes Kanban: The Board Is the Workforce

Hermes Agent (by Nous Research) introduced Kanban in v0.18.0 (July 2026). What makes it fundamentally different from every Kanban tool that came before is one architectural decision: the board and the agents are the same system.

When you create a task and assign it to a profile (e.g., "research" or "dev"), the dispatcher — a loop running inside the Hermes gateway — automatically spawns a full Hermes Agent process for that profile. The agent reads the task, does the work using its tools (terminal, file, web search, code execution, API calls), and writes the result back to the board. No human intervention required unless the task blocks on a decision.

What Makes It Different

Dimension Traditional Kanban (Trello, Jira, Linear) Hermes Kanban
Who does the work Humans only AI agent profiles — each a full OS process with tools
When work happens Business hours, when someone picks up the card 24/7 — dispatcher ticks every 60 seconds
Survives crashes No — if Jira crashes, you lose context Yes — SQLite database, block/unblock/re-run, crash recovery
Memory None — each card is isolated Each profile has persistent memory across tasks
Human in the loop Manual — you check the board Built-in — agent blocks, you get notified, you comment, agent resumes
Audit trail Limited — card activity log Permanent — SQLite rows with full run history, summaries, metadata
Task dependencies Manual — you remember which task depends on which Automatic — parent→child links, auto-promotion when parents complete
Multi-agent coordination Impossible — it's a single-user tracking tool Native — multiple named profiles collaborate on the same board
vs. delegate_task N/A delegate_task is a function call (RPC); Kanban is a durable work queue that survives restarts

Three Ways to Drive the Board

CLI

hermes kanban <verb> — 38+ subcommands from your terminal. Create, list, show, assign, dispatch, complete, archive.

Slash Command

/kanban <action> — from any chat session or gateway platform (Telegram, Discord, Slack, WhatsApp, Signal, email, SMS).

Dashboard

Visual board at port 9119 — six columns, drag-and-drop cards, run history, recovery actions, live updates via WebSocket.

How to Use It — Quick Start

# 1. Initialize the board (idempotent — safe if already exists) hermes kanban init # 2. Create a task assigned to a profile hermes kanban create "Research competitor pricing" \ --assignee research \ --body "Compare pricing tiers of top 5 competitors. Include fees and commission amounts." \ --priority 2 # 3. Start the gateway (hosts the dispatcher) hermes gateway start # 4. The dispatcher auto-spawns a worker every 60 seconds # Or trigger one immediately: hermes kanban dispatch # 5. Watch the task progress hermes kanban show <task_id> hermes kanban runs <task_id> # 6. If a worker blocks on a decision, you get notified # Comment with your answer, then unblock: hermes kanban comment <task_id> "Use the annual pricing tier, not monthly." hermes kanban unblock <task_id> # 7. The worker respawns with your feedback and completes

How to Maximize Its Use

Interactive Kanban Board

This is a live, interactive simulation of the Hermes Kanban board. Drag cards between columns to see how tasks flow through the pipeline. Each card shows the title, assigned profile, and priority — just like the real dashboard.

Board: default Drag cards between columns · click to expand
Triage 1
Research API rate limits
@research P3
Todo 1
Write integration tests
@dev P2
Ready 2
Design auth schema
@dev P1
Competitor pricing analysis
@research P2
Running 1
Generate Q3 report
@content P1
Blocked 1
Deploy to production
@dev Needs approval
Done 2
Setup project repo
@dev 229s
Research market trends
@research 412s

How the Dispatch Loop Works

Task created (ready) Dispatcher tick (60s) Claim + spawn worker Worker reads task Does the work Completes or blocks

Every step is logged as an event in the SQLite database. If the worker crashes, the dispatcher reclaims the task on the next tick and respawns. If the worker blocks, you get a notification (via Telegram, Discord, or any connected gateway platform) with the reason. You comment your answer, unblock the task, and the worker respawns with your feedback in its context.

Four Project Blueprints

These are not toy examples. Each blueprint is a real, deployable workflow that solves a genuine problem. Every one includes the full task graph, prompts, profile assignments, and pipeline structure — ready to paste into your Hermes Kanban board.

Personal Knowledge Pipeline

Personal Simple

Turn passive content consumption into a structured, searchable knowledge base. Every article, video, or paper you encounter gets researched, summarized, cross-referenced with what you already know, and filed into your notes — automatically.

Save URL @research extracts @default synthesizes @content writes to Obsidian
Profiles research, default (synthesizer), content (writer)
Workspace dir: pointing to your Obsidian vault
Depends on Obsidian vault path, web search tools, Hermes v0.18+
Time to setup ~15 minutes
Task 1 — Extract (assignee: research)
Read the content at this URL: {{URL}} Extract: main arguments, key data points, author credentials, publication date. Produce a structured summary (max 400 words) with source attribution. Call kanban_complete with the summary as metadata.
Task 2 — Synthesize (assignee: default, parent: Task 1)
Read the research summary from Task 1. Cross-reference with my last 5 knowledge base entries (search Obsidian vault for related topics). Identify: what's new, what contradicts existing knowledge, what confirms it. Produce a 200-word synthesis note with connections to prior entries. Call kanban_complete with the synthesis as metadata.
Task 3 — File (assignee: content, parent: Task 2)
Read the synthesis from Task 2. Write a formatted Markdown note to the Obsidian vault at: Knowledge/Pipeline/{{date}}-{{slug}}.md Include: frontmatter (tags, source, date), synthesis body, links to related notes. Call kanban_complete with the file path as metadata.

Autonomous Life Operations Center

Personal Advanced

A multi-profile board that runs your life logistics 24/7: health monitoring, financial tracking, learning management, and home maintenance — each domain handled by a specialist agent with persistent memory. The orchestrator profile generates a weekly life briefing every Sunday.

Cron triggers 4 specialist agents Orchestrator synthesizes Weekly briefing
Profiles research (health+finance), content (learning), dev (home maintenance), default (orchestrator)
Workspace dir: persistent directory for life ops data
Trigger Cron jobs — daily for health/finance, weekly for briefing
Depends on Health API access, expense data source, Obsidian vault, contractor search tools
Cron Job — Daily Health Check (assignee: research)
Fetch today's health metrics from connected sources. Compare to 7-day and 30-day averages. Flag any metric that deviates >15% from baseline. If anomaly detected: create a blocked task with reason "Health anomaly: {{metric}} — review recommended." Otherwise: kanban_complete with today's snapshot as metadata.
Cron Job — Daily Financial Monitor (assignee: research)
Fetch today's transactions from connected accounts. Categorize spending. Compare to monthly budget. Flag any transaction > $500 that doesn't match known patterns. If flagged: create a blocked task "Unusual transaction: {{amount}} at {{merchant}} — confirm?" Otherwise: kanban_complete with daily spend summary as metadata.
Task — Weekly Life Briefing (assignee: default, parents: all weekly tasks)
Read all completed health, financial, learning, and maintenance tasks from this week. Synthesize into a structured briefing: - Health: key metrics, trends, anomalies, recommendations - Finance: total spend, category breakdown, budget status, alerts - Learning: courses progressed, articles read, skills gained - Home: maintenance status, upcoming tasks, contractor recommendations Format as a Markdown document. Save to Obsidian vault at: Life/Briefings/{{year}}-{{week}}.md kanban_complete with briefing summary and link to file.

Client Delivery Pipeline

Business Simple

For small agencies and consultancies managing multiple clients. Each client request flows through a standardized pipeline: intake → research → draft → human review → delivery. Clients are isolated as tenants on the same board. Human-in-the-loop at the review gate only — everything else is autonomous.

Client request @research gathers context @content drafts deliverable Human reviews @content delivers
Profiles research (context), content (drafting/delivery), default (intake triage)
Workspace dir: per-client folder under Documents/Clients/
Multi-client Use --tenant client-a, --tenant client-b for isolation
Human gate Review stage only — agent blocks, you approve, agent delivers
Task 1 — Intake & Research (assignee: research, tenant: {{client}})
Client request: {{request_description}} Research the client's industry, recent news, competitor approaches to similar problems. Gather 3-5 relevant sources. Produce a context brief (max 500 words) with: - Industry context - Relevant trends - Competitor examples - Recommended approach kanban_complete with context brief as metadata.
Task 2 — Draft Deliverable (assignee: content, parent: Task 1)
Read the research context from Task 1. Draft the deliverable based on the client request: - Match the client's brand voice and format requirements - Include data points from the research - Structure for clarity (headings, bullet points, executive summary) Produce a complete draft. Do NOT send — block for human review. kanban_comment with the draft content. kanban_block("review-required: draft complete, awaiting human approval before delivery")
Task 3 — Deliver (assignee: content, parent: Task 2)
Read the reviewer's comments from Task 2's unblock. Apply any requested changes. Format the final deliverable per client requirements. Save to client folder: Documents/Clients/{{client}}/{{date}}-{{slug}}.md kanban_complete with file path and delivery summary as metadata.

Multi-Agent Product Launch Coordinator

Business Advanced

Orchestrate a full product launch across specialist profiles: market research → content production → technical QA → compliance review → timed launch execution. Each phase has parent-child dependencies. Human-in-the-loop at compliance and launch gates. The entire launch is reconstructable from the audit trail.

Market research Content production Technical QA Compliance gate Launch
Profiles research (market+compliance), content (production), dev (QA+launch), default (orchestrator)
Workspace worktree: for code QA, dir: for content, scratch for research
Human gates Compliance review + final launch approval
Timeline Phases run in parallel where possible, gated where sequential
Phase 1A — Market Research (assignee: research)
Analyze the market for {{product_name}}: - Competitor landscape (top 5, pricing, positioning, gaps) - Customer sentiment from social media, reviews, forums - Pricing benchmarks and recommended strategy - Target audience segments and messaging hooks Produce a 2-page market brief. kanban_complete with brief + metadata (sources, benchmarks).
Phase 1B — Technical QA (assignee: dev, workspace: worktree)
In the git worktree for {{repo}}: - Run full test suite, report results - Check for security vulnerabilities (scan + manual review) - Verify deployment configuration (env vars, secrets, DNS) - Performance baseline (load test if applicable) Block if ANY critical issue found. Otherwise kanban_complete with test results metadata.
Phase 2 — Content Production (assignee: content, parents: 1A)
Read the market brief from Phase 1A. Produce: - Blog post announcing the launch (800-1200 words, SEO-optimized) - Social media posts for X/LinkedIn (3 variants each) - Product documentation page (features, pricing, FAQ) - Email announcement (subject + body, 3 subject line variants) Save all assets to the content workspace. kanban_complete with file paths as metadata.
Phase 3 — Compliance Gate (assignee: research, parents: 1A, 1B, 2)
Review all produced content and technical readiness: - Legal: claims substantiation, disclaimer needs, privacy policy updates - Brand: consistency with brand guidelines, tone, visual requirements - Technical: all QA issues resolved, deployment verified If any issue: kanban_block with specific issue and remediation needed. If clear: kanban_complete with approval metadata.
Phase 4 — Launch Execution (assignee: dev, parents: 3)
Wait for human unblock (final go/no-go decision). On unblock, execute in sequence: - Deploy to production (verify HTTP 200) - Publish blog post to CMS - Schedule social posts (via Marky/Ocoya/Nuelink) - Send email campaign - Update product page - Create post-launch monitoring task (assignee: research, schedule: +24h) kanban_complete with deployment evidence + live URLs as metadata.

Frequently Asked Questions

Do I need to know how to code to use Hermes Kanban? +
No. You can drive the entire board from the dashboard (visual drag-and-drop), from slash commands in any messaging platform (Telegram, Discord, etc.), or from the CLI. The agents do the coding — you create tasks in plain English and the assigned profile executes them using its tools.
How is this different from just asking an AI chatbot to do tasks? +
A chatbot session is stateless — when you close it, the context is gone. Kanban tasks are durable: they survive crashes, restarts, and agent failures. Each task has a permanent audit trail (who did what, when, why). Multiple specialist agents collaborate on the same board. Tasks auto-depend on each other. And human-in-the-loop checkpoints are built-in — the agent blocks, you get notified, you comment your answer, and it resumes.
What if an agent crashes or produces bad output? +
The dispatcher automatically reclaims stale claims (default 4-hour timeout) and respawns workers. After 2 consecutive spawn failures (configurable), the task is auto-blocked with the error as the reason — it won't thrash forever. You can reclaim manually, reassign to a different profile, or change the profile's model and retry. Every run is logged with outcome, elapsed time, and summary — so you can diagnose what went wrong.
Can I use this for client work? +
Yes — and many of the project blueprints above are designed for exactly that. Use tenants (--tenant client-a) to isolate client work on the same board. Use dir: workspaces pointing to per-client folders. The audit trail means you can show clients exactly what was done, when, and why. Human-in-the-loop at review gates ensures quality control before anything reaches the client.
Does it work on Windows? +
Yes. Hermes Agent runs natively on Windows, macOS, and Linux. The Kanban board is a SQLite database — no external services required. The dispatcher runs inside the gateway process. The dashboard is a local web server on port 9119. Everything is self-contained on your machine.

Start Building with AI-Native Kanban

Hermes Agent is open-source, MIT-licensed, and runs on your machine. Install it, enable Kanban, and put your first task on the board today.