AI-powered Kanban TUI for autonomous development workflows

Documentation • Install • Quickstart • Issues

---

Terminal Kanban board with integrated AI agents for autonomous and collaborative development. Review mode surfaces merge readiness and conflict guidance.

Install

=== "UV (Recommended)"

uv tool install kagan

=== "Mac / Linux"

curl -fsSL https://uvget.me/install.sh | bash -s -- kagan

=== "Windows (PowerShell)"

iwr -useb uvget.me/install.ps1 -OutFile install.ps1; .\install.ps1 kagan

=== "pip"

pip install kagan

Requirements

• Python 3.12 -- 3.13, Git, terminal 80x20+
• tmux (recommended for PAIR sessions on macOS/Linux)
• VS Code or Cursor (PAIR launchers, especially on Windows)

Usage

kagan              # Launch TUI (default command)
kagan tui          # Launch TUI explicitly
kagan core status  # Show status of the core process
kagan core stop    # Stop the running core process
kagan mcp          # Run as MCP server (connects to core via IPC)
kagan tools        # Stateless developer utilities (prompt enhancement)
kagan update       # Check for and install updates
kagan list         # List all projects with task counts
kagan reset        # Reset data (interactive)
kagan --help       # Show all options

Ways To Use Kagan

TUI-first (interactive)

Run kagan -- create tasks, run AUTO/PAIR workflows, review/rebase/merge, switch projects.

MCP delegation (admin lane)

Operate from your AI CLI while Kagan stays source of truth:

kagan mcp --identity kagan_admin --capability maintainer --session-id ext:orchestrator

Use viewer/pair_worker profiles for safer day-to-day automation.

User-Facing Features

• Board lifecycle: BACKLOG -> IN_PROGRESS -> REVIEW -> DONE
• Task CRUD, duplicate, inspect details
• Work modes: AUTO (background agent), PAIR (interactive session)
• Chat-driven planning with approval flow
• Review: diff output, approve/reject/rebase/merge
• Multi-repo: project/repo switching, base-branch controls
• PAIR handoff: session management + human redirect (tmux/VS Code/Cursor)
• MCP: 23 tools spanning tasks, sessions, review, planning, projects, audit, settings
• Core daemon management: run, inspect, stop

Supported AI CLIs

• Claude Code (Anthropic)
• OpenCode (SST)
• Codex (OpenAI)
• Gemini CLI (Google)
• Kimi CLI (Moonshot AI)
• GitHub Copilot (GitHub)

Documentation

Full docs at docs.kagan.sh -- User Guide | MCP Server

License

MIT

---