Metadata-Version: 2.4
Name: kagan
Version: 0.3.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: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Terminals
Classifier: Topic :: Utilities
Classifier: Typing :: Typed
Requires-Python: <3.14,>=3.12
Requires-Dist: agent-client-protocol<1.0.0,>=0.7.0
Requires-Dist: aiofiles>=24.1.0
Requires-Dist: aiosqlite>=0.22.0
Requires-Dist: click>=8.1.0
Requires-Dist: filelock>=3.16.0
Requires-Dist: greenlet>=3.1.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.0.0
Requires-Dist: mslex>=1.3.0
Requires-Dist: packaging>=24.0
Requires-Dist: platformdirs>=4.3.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: sqlmodel>=0.0.22
Requires-Dist: textual>=7.0.0
Requires-Dist: tomlkit>=0.13.0
Requires-Dist: typeguard>=4.4.0
Description-Content-Type: text/markdown

<p align="center">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset=".github/assets/logo-dark.svg">
    <source media="(prefers-color-scheme: light)" srcset=".github/assets/logo-light.svg">
    <img alt="Kagan" src=".github/assets/logo-light.svg" width="480">
  </picture>
</p>

<p align="center">
  <strong>AI-powered Kanban TUI for autonomous development workflows</strong>
</p>

<p align="center">
  <a href="https://pypi.org/project/kagan/"><img src="https://img.shields.io/pypi/v/kagan?style=for-the-badge" alt="PyPI"></a>
  <a href="https://pypi.org/project/kagan/"><img src="https://img.shields.io/pypi/pyversions/kagan?style=for-the-badge" alt="Python"></a>
  <a href="https://opensource.org/license/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge" alt="License: MIT"></a>
  <a href="https://github.com/aorumbayev/kagan/stargazers"><img src="https://img.shields.io/github/stars/aorumbayev/kagan?style=for-the-badge" alt="Stars"></a>
</p>

<p align="center">
  <a href="https://docs.kagan.sh">Documentation</a> •
  <a href="https://docs.kagan.sh/install">Install</a> •
  <a href="https://docs.kagan.sh/quickstart">Quickstart</a> •
  <a href="https://github.com/aorumbayev/kagan/issues">Issues</a>
</p>

---

<p align="center">
  <img src="https://i.imgur.com/dZRl5V7.png" alt="Kagan Screenshot" width="700">
</p>

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)"

```bash
uv tool install kagan
```

=== "Mac / Linux"

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

=== "Windows (PowerShell)"

```powershell
iwr -useb uvget.me/install.ps1 -OutFile install.ps1; .\install.ps1 kagan
```

=== "pip"

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

```bash
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](https://docs.anthropic.com/en/docs/claude-code) (Anthropic)
- [OpenCode](https://opencode.ai/docs) (SST)
- [Codex](https://github.com/openai/codex) (OpenAI)
- [Gemini CLI](https://github.com/google-gemini/gemini-cli) (Google)
- [Kimi CLI](https://github.com/MoonshotAI/kimi-cli) (Moonshot AI)
- [GitHub Copilot](https://github.com/github/copilot-cli) (GitHub)

## Documentation

**Full documentation available at [docs.kagan.sh](https://docs.kagan.sh)**

## License

[MIT](LICENSE)

---

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