Metadata-Version: 2.4
Name: kagan
Version: 0.2.0
Summary: AI-powered Kanban TUI for autonomous development workflows
Project-URL: Homepage, https://kagan.sh
Project-URL: Documentation, https://docs.kagan.sh
Project-URL: Repository, https://github.com/aorumbayev/kagan
Project-URL: Issues, https://github.com/aorumbayev/kagan/issues
Project-URL: Changelog, https://github.com/aorumbayev/kagan/blob/main/CHANGELOG.md
Author-email: Altynbek Orumbayev <altynbek.orumbayev@makerx.com.au>
License-Expression: MIT
License-File: LICENSE
Keywords: ai,autonomous,kanban,project-management,terminal,textual,tui
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Terminals
Classifier: Topic :: Utilities
Classifier: Typing :: Typed
Requires-Python: >=3.12
Requires-Dist: aiosqlite>=0.22.0
Requires-Dist: click>=8.1.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.0.0
Requires-Dist: packaging>=24.0
Requires-Dist: psutil>=7.0.0
Requires-Dist: pydantic>=2.10.0
Requires-Dist: pyperclip>=1.11.0
Requires-Dist: rich>=14.0.0
Requires-Dist: textual>=7.0.0
Requires-Dist: typeguard>=4.4.0
Description-Content-Type: text/markdown

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

> AI-powered Kanban TUI for autonomous development workflows

[![GitHub release (latest by date)](https://img.shields.io/github/v/release/aorumbayev/kagan)](https://github.com/aorumbayev/kagan/releases/latest)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![PyPI version](https://badge.fury.io/py/kagan.svg)](https://badge.fury.io/py/kagan)

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

![Kagan Screenshot](https://i.imgur.com/dZRl5V7.png)

## Supported AI CLIs

Available now:

- Claude Code
- OpenCode

Coming soon:

- Gemini
- Codex
- More providers

## Install

### Quick Install (with uv)

```bash
uv tool install kagan
```

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

```bash
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

```bash
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](docs/index.md) for complete keybindings.

## Documentation

See the [docs/](docs/) folder for detailed documentation:

- [User Guide](docs/index.md) - Full walkthrough of workflows
- [Configuration](docs/config.md) - Agent setup and options
- [Contributing](CONTRIBUTING.md) - Development guidelines

## License

[MIT](LICENSE)

---

<a href="https://www.star-history.com/#aorumbayev/kagan&type=date&legend=top-left">
 <picture>
   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=aorumbayev/kagan&type=date&theme=dark&legend=top-left" />
   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=aorumbayev/kagan&type=date&legend=top-left" />
   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=aorumbayev/kagan&type=date&legend=top-left" />
 </picture>
</a>
