README

A Kanban board your coding agents work, and you approve.

Quick start#

bash
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.db next 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 a kanbo command 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, return and column changes are a person's; an agent's shell is refused with exit code 4, and on Postgres the database roles refuse it too. See agents.
  • Watch it in a terminal, or in your browser. kanbo board and the interactive home screen, or kanbo serve for 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#

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.