kagan 0.6.0b1

AI-powered Kanban TUI for autonomous development workflows

A terminal task board that runs AI agents on your code — you review, you decide, you merge.

Documentation • Quickstart • MCP Setup • CLI Reference • Issues

---

Create a task. Pick a mode. The agent works. You review, approve, and merge.

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 (interactive)

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

Editor (MCP)

Operate Kagan from Claude Code, Gemini CLI, or any MCP-compatible client -- no TUI required:

kagan mcp --capability pair_worker

Start with pair_worker. Escalate to maintainer when needed. See MCP setup for editor configs.

Features

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

Supported Agents

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

Docs

docs.kagan.sh -- Quickstart | MCP Setup | Editor MCP Setup

License

MIT

---