Kanban for AI Agents
Track and coordinate tasks between humans and AI in the terminal

Features • Installation • MCP Integration • CLI • TUI • AI Editors

Kaban is a terminal-based Kanban board designed for AI code agents and developers. It provides a structured way to manage tasks, track progress, and coordinate between human users and AI agents.

Why Kaban?

• Manage Todos — Track tasks with a proper Kanban board
• Assign to Agents — Assign tasks to Claude, GPT, or any AI agent
• Single App — No servers, no cloud. One SQLite file. Works offline
• TUI + CLI + MCP — Interactive UI for humans, CLI for scripts, MCP for AI

# Try without installing
npx @kaban-board/cli init --name "My Project"
npx @kaban-board/cli tui

# Or with bun
bunx @kaban-board/cli tui

npm install -g @kaban-board/cli
kaban init --name "My Project"
kaban tui

brew tap beshkenadze/tap
brew install kaban
kaban tui

git clone https://github.com/beshkenadze/kaban
cd kaban && bun install && bun run build
task install

• Node.js v18+ or Bun v1.0+
• Task (optional, for development)

Kaban is a monorepo with three packages:

Connect your AI coding assistant to Kaban via Model Context Protocol.

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "kaban": {
      "command": "npx",
      "args": ["-y", "@kaban-board/cli", "mcp"],
      "env": {
        "KABAN_PATH": "/path/to/your/project"
      }
    }
  }
}

Or if installed globally:

{
  "mcpServers": {
    "kaban": {
      "command": "kaban",
      "args": ["mcp"],
      "env": {
        "KABAN_PATH": "/path/to/your/project"
      }
    }
  }
}

kaban <command> [options]

# Initialize with custom name
kaban init --name "Sprint 1"

# Add task with metadata
kaban add "Fix auth bug" -c todo -a claude -D "OAuth2 flow broken"

# List tasks in a column
kaban list --column in-progress

# Move task to next column
kaban move abc123 --next

# Mark complete
kaban done abc123

Launch the interactive terminal UI:

kaban tui

Add Kaban MCP server to your AI coding assistant:

Add to .mcp.json (Claude Code) or claude_desktop_config.json:

{
  "mcpServers": {
    "kaban": {
      "command": "npx",
      "args": ["-y", "@kaban-board/cli", "mcp"]
    }
  }
}

Add to opencode.json:

{
  "mcp": {
    "kaban": {
      "command": "npx",
      "args": ["-y", "@kaban-board/cli", "mcp"]
    }
  }
}

Add to MCP settings:

{
  "mcpServers": {
    "kaban": {
      "command": "npx",
      "args": ["-y", "@kaban-board/cli", "mcp"]
    }
  }
}

If you installed globally (npm i -g @kaban-board/cli), use:

{
  "mcpServers": {
    "kaban": {
      "command": "kaban",
      "args": ["mcp"]
    }
  }
}

Kaban stores data in .kaban/ directory:

.kaban/
├── board.db      # SQLite database
└── config.json   # Board configuration

Contributions are welcome! Please read our Contributing Guide first.

# Development
bun install
bun run build
bun run lint
bun run test

MIT