kagan 0.2.0

AI-powered Kanban TUI for autonomous development workflows

██╗  ██╗ █████╗  ██████╗  █████╗ ███╗   ██╗
██║ ██╔╝██╔══██╗██╔════╝ ██╔══██╗████╗  ██║
█████╔╝ ███████║██║  ███╗███████║██╔██╗ ██║
██╔═██╗ ██╔══██║██║   ██║██╔══██║██║╚██╗██║
██║  ██╗██║  ██║╚██████╔╝██║  ██║██║ ╚████║
╚═╝  ╚═╝╚═╝  ╚═╝ ╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═══╝

AI-powered Kanban TUI for autonomous development workflows

Kagan is a terminal-based Kanban board that integrates AI agents to help you complete development tasks autonomously or collaboratively.

Supported AI CLIs

Available now:

• Claude Code
• OpenCode

Coming soon:

• Gemini
• Codex
• More providers

Install

Quick Install (with uv)

uv tool install kagan

All-in-One Install (includes uv + Python)

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

[!NOTE] The all-in-one installer automatically installs uv and Python if needed, then installs Kagan via uv tool install.

Usage

kagan                  # Launch TUI
kagan mcp             # Run as MCP server
kagan --help          # Show all options

Key Shortcuts

Kagan is keyboard-first. Here are the essential shortcuts:

Key	Action
Navigation
h/j/k/l	Move focus (vim-style)
Tab/Shift+Tab	Cycle columns
Tickets
n	New ticket
v	View details
e	Edit ticket
x	Delete ticket
Enter	Open session (PAIR) / watch agent (AUTO)
a	Start agent (AUTO mode)
w	Watch agent output
Leader (g + key)
g h/l	Move ticket left/right
g r	Review ticket
g d	View diff
Review
D	View diff
r	Open review modal
m	Merge ticket
Global
p	Planner mode
,	Settings
?	Help
Ctrl+P	Command palette
q	Quit

See docs/index.md for complete keybindings.

Documentation

See the docs/ folder for detailed documentation:

• User Guide - Full walkthrough of workflows
• Configuration - Agent setup and options
• Contributing - Development guidelines

License

MIT

---