kagan 0.4.0b1

AI-powered Kanban TUI for autonomous development workflows

AI-powered Kanban TUI for autonomous development workflows

Documentation • Install • Quickstart • Issues

---

Kagan is a terminal-based Kanban board that integrates AI agents to help you complete development tasks autonomously or collaboratively. Review mode highlights merge readiness and conflict resolution guidance to prevent surprise merge failures.

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 repository (for worktrees)
• tmux (recommended on macOS/Linux for native PAIR terminal sessions)
• VS Code or Cursor (supported PAIR launchers, especially on Windows)
• Terminal (minimum 80x20 characters)

Usage

kagan              # Launch TUI (default command)
kagan tui          # Launch TUI explicitly
kagan mcp          # Run as MCP server
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

Supported AI CLIs

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

Documentation

Full documentation available at docs.kagan.sh

License

MIT

---