Summary
Connects Claude to a Kanban workflow system built around AI agent orchestration with mandatory human review gates. The MCP server exposes operations to create tasks, move cards through BACKLOG, IN_PROGRESS, REVIEW, and DONE states, and manage isolated git worktrees where agents execute work. The state machine enforces that no task reaches DONE without explicit human approval at the REVIEW stage. You'd reach for this when you want AI agents handling implementation while keeping yourself in the loop as a structural checkpoint before any code hits main. Works with Claude Code, Codex, Gemini CLI, and other MCP clients. The server sits alongside a TUI, optional web dashboard, and VS Code extension that all share the same board state.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Docs · Quickstart · The review gate · MCP Setup · CLI Reference · Contributing
Kagan is a Kanban TUI for AI coding agents with a structural human review gate. No agent-authored task reaches your main branch without an explicit approval — the state machine enforces it.
The agent runs in an isolated git worktree. When it finishes, the task card moves to REVIEW. You read the diff, check the acceptance criteria, and press approve. Then merge fires. That transition — REVIEW to DONE — cannot be automated away. It is not a setting.
Install
uv tool install kagan # or: uvx kagan
Mac / Linux (no uv)
curl -fsSL https://uvget.me/install.sh | bash -s -- kagan
Windows (PowerShell)
iwr -useb uvget.me/install.ps1 -OutFile install.ps1; .\install.ps1 kagan
What you get
- Kanban board (BACKLOG → IN_PROGRESS → REVIEW → DONE) enforced by a state machine
- Each task runs in its own git worktree — your working copy stays untouched
- Managed runs (background agent) or interactive attach (you + agent in tmux/editor)
- REVIEW stage requires explicit human approval before merge; no path around it
- MCP server so Claude Code, Codex, or any MCP-capable client can drive the board
kagan doctorpreflight checks all required tools before first run
Tested agents: Claude Code · Codex · Gemini CLI · 11 more — see docs/backends.
Full docs: docs.kagan.sh
Companion surfaces
The TUI (kagan) is the primary operator surface. Two companion surfaces exist for specific workflows:
- Web dashboard (
kagan web) — browser-based board, useful for remote access or a second monitor - VS Code extension — sidebar panel and
@kaganchat participant inside VS Code
Both companions share the same state as the TUI via the same API server. Neither is required.
License
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Configuration
KAGAN_OPENAI_API_KEYsecretOpenAI API key for agent execution (if using OpenAI backend)
KAGAN_ANTHROPIC_API_KEYsecretAnthropic API key for agent execution (if using Claude backend)
KAGAN_DB_PATHCustom path for Kagan database file
Categories
Registryactive
Packagekagan
TransportSTDIO
AuthRequired
UpdatedMar 23, 2026
