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.

Features

Agent sessions

Every ticket runs an AI agent in its own git worktree, inside a Docker container — no contention, no rebasing pain.
Reuses the target repo's .devcontainer/devcontainer.json, or falls back to a bundled Ubuntu devcontainer (git, gh, node, Go) so any repo works with zero setup.
Pluggable harnesses (Claude Code, pi.dev), switchable globally in settings.
Drive the agent from a full terminal in the browser, plus a second plain shell — both backed by a WASM terminal emulator.
Claude Code conversations resume automatically across container and server restarts.

Boards & tickets

Kanban boards tied to a git repo, with configurable columns and drag-and-drop tickets with markdown bodies.
Sync (rebase/merge from base) and merge (merge-commit / squash / rebase) straight from the ticket panel.
Optional AI-generated merge commit messages and per-board commit identity.
Archive, unarchive, and delete tickets; archived drawer with bulk actions.
Multi-board overview with tiling, resizable session panels for working several tickets at once.

Diff, tasks & ports

Built-in diff viewer with a changed-files tree, syntax highlighting, whole-file view, and expandable context.
Tasks tab discovers .vscode/tasks.json tasks, runs them, streams live output, and stops them.
Per-task port forwarding proxies in-container dev servers to host ports 13000–13099 and surfaces them on the ticket.
Plans tab renders the .md plans the agent writes (e.g. Claude Code's /plan mode).

GitHub integration

Auto-moves tickets when their linked PR or issue changes state, with configurable column mappings.
Live PR detail: diff totals, rolled-up review decision, and CI check status.
Build Cop polls GitHub Actions and files tickets for jobs whose failure rate crosses a threshold, on its own auto-managed board (Failing / Investigating / Fixed / Won't fix).

Interfaces & ops

Web UI with light / dark / high-contrast themes, accent colors, and remappable keyboard shortcuts.
REST API with Server-Sent Events for live updates, an MCP server for Claude Desktop / Claude Code, and noun-verb CLI subcommands.
Ships as a single self-contained ~20 MB Go binary — also distributed as a Docker image and a PyPI wrapper — backed by local SQLite.
Prometheus /metrics and a /health endpoint; project + user .kanban.toml config that merge.

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/.pi/agent:$HOME/.pi/agent \
  -v $HOME/.local/share/kanban:$HOME/.local/share/kanban \
  -v $HOME/.gitconfig:$HOME/.gitconfig:ro \
  -v $HOME/.config/git:$HOME/.config/git:ro \
  -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.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

agentic_kanban-1.3.2-py3-none-win_arm64.whl (14.7 MB view details)

Uploaded Aug 17, 2026 Python 3Windows ARM64

agentic_kanban-1.3.2-py3-none-win_amd64.whl (15.7 MB view details)

Uploaded Aug 17, 2026 Python 3Windows x86-64

agentic_kanban-1.3.2-py3-none-manylinux_2_17_x86_64.whl (15.5 MB view details)

Uploaded Aug 17, 2026 Python 3manylinux: glibc 2.17+ x86-64

agentic_kanban-1.3.2-py3-none-manylinux_2_17_aarch64.whl (14.7 MB view details)

Uploaded Aug 17, 2026 Python 3manylinux: glibc 2.17+ ARM64

agentic_kanban-1.3.2-py3-none-macosx_11_0_arm64.whl (15.2 MB view details)

Uploaded Aug 17, 2026 Python 3macOS 11.0+ ARM64

agentic_kanban-1.3.2-py3-none-macosx_10_12_x86_64.whl (15.6 MB view details)

Uploaded Aug 17, 2026 Python 3macOS 10.12+ x86-64

agentic_kanban-1.3.2-py3-none-any.whl (15.5 MB view details)

Uploaded Aug 17, 2026 Python 3

File details

Details for the file agentic_kanban-1.3.2-py3-none-win_arm64.whl.

File metadata

Download URL: agentic_kanban-1.3.2-py3-none-win_arm64.whl
Upload date: Aug 17, 2026
Size: 14.7 MB
Tags: Python 3, Windows ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for agentic_kanban-1.3.2-py3-none-win_arm64.whl
Algorithm	Hash digest
SHA256	`d887c9903b081259c87f6b55cd707b848454143b6553f6e4ef3e2dfe3fe49dab`
MD5	`0fddd28e3e9e49ddd64e171d48514191`
BLAKE2b-256	`b4f2628d75e2c71dbeab21a9d06e5f1ea2de998599d20e26e829f52c3bc8bd8c`

See more details on using hashes here.

File details

Details for the file agentic_kanban-1.3.2-py3-none-win_amd64.whl.

File metadata

Download URL: agentic_kanban-1.3.2-py3-none-win_amd64.whl
Upload date: Aug 17, 2026
Size: 15.7 MB
Tags: Python 3, Windows x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for agentic_kanban-1.3.2-py3-none-win_amd64.whl
Algorithm	Hash digest
SHA256	`1673186e932162b6a229f88f7313c5ea4462eb3fb27b1669f3bce09fc976989a`
MD5	`b384bf2eb562b40dbbdaa3d50e21f2ce`
BLAKE2b-256	`378ea76b1176066f07e1bffe77a67a80bf0486b1749c679f1c0fa4c003f34eb7`

See more details on using hashes here.

File details

Details for the file agentic_kanban-1.3.2-py3-none-manylinux_2_17_x86_64.whl.

File metadata

Download URL: agentic_kanban-1.3.2-py3-none-manylinux_2_17_x86_64.whl
Upload date: Aug 17, 2026
Size: 15.5 MB
Tags: Python 3, manylinux: glibc 2.17+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for agentic_kanban-1.3.2-py3-none-manylinux_2_17_x86_64.whl
Algorithm	Hash digest
SHA256	`26469113950d1b4690606480b2aab60233577d28ceee60d4c82210483c0e0af7`
MD5	`eb1a2fc69235230d83c428c3603fcbc7`
BLAKE2b-256	`a8e7df49244ebe47cb6c73c9afd3c7047e82649a88513c5ea94d5df5de057402`

See more details on using hashes here.

File details

Details for the file agentic_kanban-1.3.2-py3-none-manylinux_2_17_aarch64.whl.

File metadata

Download URL: agentic_kanban-1.3.2-py3-none-manylinux_2_17_aarch64.whl
Upload date: Aug 17, 2026
Size: 14.7 MB
Tags: Python 3, manylinux: glibc 2.17+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for agentic_kanban-1.3.2-py3-none-manylinux_2_17_aarch64.whl
Algorithm	Hash digest
SHA256	`ecf7322308e7788f60fd38b2ef1c6a660f51c6c3b7172e11793101a587dcab22`
MD5	`b2939f2d2c7bd7bb551af98f2d1ae9b7`
BLAKE2b-256	`59c252fed9f6c093c2c81d3ef69cc4859620c41e43ea908bf5a51735a073b8dd`

See more details on using hashes here.

File details

Details for the file agentic_kanban-1.3.2-py3-none-macosx_11_0_arm64.whl.

File metadata

Download URL: agentic_kanban-1.3.2-py3-none-macosx_11_0_arm64.whl
Upload date: Aug 17, 2026
Size: 15.2 MB
Tags: Python 3, macOS 11.0+ ARM64
Uploaded using Trusted Publishing? Yes
Uploaded via: uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for agentic_kanban-1.3.2-py3-none-macosx_11_0_arm64.whl
Algorithm	Hash digest
SHA256	`3606efcbe8666b1b9ece199ad3ecdb27e24f6fefb23a16e81f295e73510c6e8f`
MD5	`88dcc64d14ff573ed15bad35f8530ac7`
BLAKE2b-256	`1426ce33773b20e691feae562259f9f5479681e60829ae006aa977105142d580`

See more details on using hashes here.

File details

Details for the file agentic_kanban-1.3.2-py3-none-macosx_10_12_x86_64.whl.

File metadata

Download URL: agentic_kanban-1.3.2-py3-none-macosx_10_12_x86_64.whl
Upload date: Aug 17, 2026
Size: 15.6 MB
Tags: Python 3, macOS 10.12+ x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for agentic_kanban-1.3.2-py3-none-macosx_10_12_x86_64.whl
Algorithm	Hash digest
SHA256	`bc7dcf41df4f3372d0944873f6417252c40029cea7097993078293d4537bfd0c`
MD5	`20e68653ca350aa5f55ca63bb9ff96db`
BLAKE2b-256	`d51393b17f6430e944e4279f23461131601d29f634959c41889f37a7a157a7fb`

See more details on using hashes here.

File details

Details for the file agentic_kanban-1.3.2-py3-none-any.whl.

File metadata

Download URL: agentic_kanban-1.3.2-py3-none-any.whl
Upload date: Aug 17, 2026
Size: 15.5 MB
Tags: Python 3
Uploaded using Trusted Publishing? Yes
Uploaded via: uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for agentic_kanban-1.3.2-py3-none-any.whl
Algorithm	Hash digest
SHA256	`88eeb8761184ad3c2c906a185a22541765348a71664db3923b1fb15c3a7e84e3`
MD5	`c69b1fff7be81b8d6b37ff0f5b54a3ee`
BLAKE2b-256	`731200175c2a4503d17dd693eeebc04e981f24b236d2e1506b1372e8d5ae65be`