kagan-legacy

# Kagan Documentation

> Documentation for Kagan: 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.

Kagan runs coding agents (Claude Code, Codex, Gemini CLI, and 11 more) in isolated git worktrees. When an agent finishes, the task lands in REVIEW. A human approves and merges. That gate is structural — not a setting.

## Docs

- [Home](https://docs.kagan.sh/): Documentation home
- [Quickstart](https://docs.kagan.sh/quickstart/): Install, run a task, review, and merge in under 5 minutes
- [The review gate](https://docs.kagan.sh/concepts/task-lifecycle/): How the state machine enforces human review before merge
- [Backends](https://docs.kagan.sh/concepts/architecture-overview/): Supported agents and interactive launchers
- [Managed Runs](https://docs.kagan.sh/guides/managed-vs-interactive/): Run modes — managed vs interactive attach
- [Chat & REPL](https://docs.kagan.sh/guides/chat/): Interactive chat orchestrator
- [ACP Sessions](https://docs.kagan.sh/guides/acp-session-lifecycle/): Chat session lifecycle management
- [MCP Setup](https://docs.kagan.sh/guides/mcp-setup/): Editor integration via MCP
- [Web Dashboard](https://docs.kagan.sh/guides/web-dashboard/): Browser-based companion surface
- [VS Code Extension](https://docs.kagan.sh/guides/vscode-extension/): VS Code companion surface
- [GitHub integration](https://docs.kagan.sh/guides/github/): Two-way metadata sync (title, body, labels, criteria), create-and-link, `#`-mention autocomplete; status lifecycles stay independent
- [GitHub Models](https://docs.kagan.sh/guides/github-models/): Use 40+ LLMs for free via GitHub Models
- [Remote Access](https://docs.kagan.sh/guides/remote-access/): Access Kagan from web or phone
- [CLI Reference](https://docs.kagan.sh/reference/cli/): All CLI commands and flags
- [Configuration](https://docs.kagan.sh/reference/configuration/): Config.toml reference
- [Keybindings](https://docs.kagan.sh/reference/keybindings/): TUI and web shortcuts; orchestrator overlay cycles attached agent streams with `Ctrl+↑` / `Ctrl+↓` (TUI) and `Cmd/Ctrl+↑` / `Cmd/Ctrl+↓` (web). Kanban fullscreen-AI is `Ctrl+F`.
- [MCP Tools](https://docs.kagan.sh/reference/mcp-tools/): Full MCP tool catalog (23+ tools)
- [Integrations](https://docs.kagan.sh/guides/github/): GitHub two-way sync
- [Troubleshooting](https://docs.kagan.sh/troubleshooting/): Common issues and fixes

## Links

- [Landing Page](https://kagan.sh/): Product homepage
- [GitHub](https://github.com/kagan-sh/kagan): Source code
- [PyPI](https://pypi.org/project/kagan/): Python package
- [Discord](https://discord.gg/dB5AgMwWMy): Community