Agentic Kanban

A kanban board for managing AI agent sessions.

Each ticket is bound to an agent session (Claude Code, pi.dev) running inside its own git worktree, executed in the target repository's existing devcontainer. The active harness is selected globally in the app's settings.

Install

uv tool install agentic-kanban

This installs the binary to ~/.local/bin/kanban. Make sure to have that on your PATH.

Run

kanban serve

The server listens on :7474. Open http://localhost:7474/.

Or with Docker:

SOURCE=$HOME/code
docker run -d --name kanban \
  --restart unless-stopped \
  -p 127.0.0.1:7474:7474 \
  -p 13000-13099:13000-13099 \
  -v ${DOCKER_SOCK_PATH:-/var/run/docker.sock}:/var/run/docker.sock \
  -v $HOME/.claude:$HOME/.claude \
  -v $HOME/.claude.json:$HOME/.claude.json \
  -v $HOME/.local/share/kanban:$HOME/.local/share/kanban \
  -v $SOURCE:$SOURCE \
  -e HOME=$HOME \
  -e XDG_RUNTIME_DIR=$XDG_RUNTIME_DIR \
  -e KANBAN_DATA_DIR=$HOME/.local/share/kanban \
  -e KANBAN_HOST_DOCKER_SOCK=${DOCKER_SOCK_PATH:-/var/run/docker.sock} \
  -e GH_TOKEN=$(gh auth token) \
  lahmanja/kanban:latest

📖 Documentation

Full documentation lives at https://jmelahman.github.io/agentic-kanban/:

• Quickstart — your first board and ticket in five minutes.
• Configuration — .kanban.toml schema and merge rules.
• REST API — endpoints exposed by the running server.
• CLI — serve, mcp, board list, ticket create.
• MCP — Claude Desktop / Claude Code integration.