kanbo
A Kanban board your coding agents work, and you approve.
Quick start
npm install -g kanbo-cli
cd your-project && kanbo
Then tell your agent: "take the next card from kanbo."
kanbo with no board here starts a short setup wizard; run it again any time for the home screen. See Getting started for the walkthrough — every question it asks, what your agent does, and how to approve a card.
What you get
- A board in a file, or a shared Postgres database.
.kanbo/board.dbnext to your code for one project on one machine, or an external Postgres (Supabase works) for a team of people and agents. See storage. - Agents work it over MCP or the CLI. Sixteen
kanbo_*MCP tools, and akanbocommand for every one of them — an agent with or without MCP works the same board. See MCP reference and CLI reference. - You approve. kanbo enforces it, not just asks.
approve,returnand column changes are a person's; an agent's shell is refused with exit code4, and on Postgres the database roles refuse it too. See agents. - Watch it in a terminal, or in your browser.
kanbo boardand the interactive home screen, orkanbo servefor a board page over HTTP. See HTTP API.
Works with
Claude Code, Codex, Cursor, Gemini CLI — and anything else that can run a shell command or speak MCP over stdio. See using kanbo with agents.
Documentation
- Getting started — the wizard, the home screen, connecting an agent, approving a card
- Installation — npm, npx, from source, native module notes, upgrading
- Using kanbo with agents — global setup, per project, per agent; the agent-vs-person rules
- Orchestrator examples — instruction files, Claude Code subagents, Codex, a shell loop, a worked session
- CLI reference — every command and flag
- MCP reference — every
kanbo_*tool and its inputs - HTTP API —
kanbo serve, routes, security model, the board page - Storage — board files, shared Postgres/Supabase, roles, schema, migrations
- Configuration —
KANBO_*environment variables and.kanbo/binding.json - Performance and Agent efficiency — how fast, and how many tool calls an agent needs
- FAQ · Troubleshooting
- Full index · Contributing · Security · Changelog
License
PolyForm Noncommercial 1.0.0 — free for noncommercial use (personal, research, educational, and more; read the license for the exact terms). Commercial use — selling it, or building it into a paid product or service — needs a separate license: write to [email protected].
Versions up to and including 0.2.0 were released under MIT and stay under MIT.