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.jsontasks, runs them, streams live output, and stops them. - Per-task port forwarding proxies in-container dev servers to host ports
13000–13099and surfaces them on the ticket. - Plans tab renders the
.mdplans the agent writes (e.g. Claude Code's/planmode).
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
/metricsand a/healthendpoint; project + user.kanban.tomlconfig 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.tomlschema and merge rules. - REST API — endpoints exposed by the running server.
- CLI —
serve,mcp,board list,ticket create. - MCP — Claude Desktop / Claude Code integration.
1 maintainer
Release files for agentic-kanban 1.5.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| agentic_kanban-1.5.0-py3-none-win_arm64.whl | Python 3 | none | Windows ARM64 | Details |
| agentic_kanban-1.5.0-py3-none-win_amd64.whl | Python 3 | none | Windows x86-64 | Details |
| agentic_kanban-1.5.0-py3-none-manylinux_2_17_x86_64.whl | Python 3 | none | Linux glibc 2.17+ x86-64 | Details |
| agentic_kanban-1.5.0-py3-none-manylinux_2_17_aarch64.whl | Python 3 | none | Linux glibc 2.17+ ARM64 | Details |
| agentic_kanban-1.5.0-py3-none-macosx_11_0_arm64.whl | Python 3 | none | macOS 11.0+ ARM64 | Details |
| agentic_kanban-1.5.0-py3-none-macosx_10_12_x86_64.whl | Python 3 | none | macOS 10.12+ x86-64 | Details |
| agentic_kanban-1.5.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 109.4 MB
Release files / agentic_kanban-1.5.0-py3-none-win_arm64.whl
| Download URL | agentic_kanban-1.5.0-py3-none-win_arm64.whl |
|---|---|
| Size | 15.1 MB |
| Tags | Python 3 Windows ARM64 |
|
SHA-256 checksum How to use checksums |
98e5ede0ea27e4420652ab767563970d1ecf52bb1df802f5119632a14435639d
|
|
BLAKE2b-256 checksum How to use checksums |
0ef9de22fb6376f053462f004499fdfd63b070de6cd931780d0a051c885db976
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.18 {"installer":{"name":"uv","version":"0.12.18","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}
|
Release files / agentic_kanban-1.5.0-py3-none-win_amd64.whl
| Download URL | agentic_kanban-1.5.0-py3-none-win_amd64.whl |
|---|---|
| Size | 16.1 MB |
| Tags | Python 3 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
477009610a6e7736571b2a8d16930a19d0a4badcdcd006237e8bde31c95b83e6
|
|
BLAKE2b-256 checksum How to use checksums |
8f04e5504a1d9241c3be677e413dd38a091e794f3f4eb7179d8886699b3ec83e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.18 {"installer":{"name":"uv","version":"0.12.18","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}
|
Release files / agentic_kanban-1.5.0-py3-none-manylinux_2_17_x86_64.whl
| Download URL | agentic_kanban-1.5.0-py3-none-manylinux_2_17_x86_64.whl |
|---|---|
| Size | 15.9 MB |
| Tags | Linux glibc 2.17+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
0ff68e4dd708f87b4b74c491c8716ff4284f2fa0c7c7c6dacff2b6bca33e1e40
|
|
BLAKE2b-256 checksum How to use checksums |
530bef2c7b01da1a0fa7534af92eb8da7c37830ab7c89a7168c51844dd6d16e7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.18 {"installer":{"name":"uv","version":"0.12.18","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}
|
Release files / agentic_kanban-1.5.0-py3-none-manylinux_2_17_aarch64.whl
| Download URL | agentic_kanban-1.5.0-py3-none-manylinux_2_17_aarch64.whl |
|---|---|
| Size | 15.0 MB |
| Tags | Linux glibc 2.17+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
bcc5484783f63a9623153bb16ab31d6fbebfcf44719b324422482ebeb754046b
|
|
BLAKE2b-256 checksum How to use checksums |
0e8136fe3d6e58c51b4d2e014e2fd6093f8d077475d9e549ce637c71fd6f41bc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.18 {"installer":{"name":"uv","version":"0.12.18","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}
|
Release files / agentic_kanban-1.5.0-py3-none-macosx_11_0_arm64.whl
| Download URL | agentic_kanban-1.5.0-py3-none-macosx_11_0_arm64.whl |
|---|---|
| Size | 15.6 MB |
| Tags | Python 3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
ad947d218ac7aa174941342bb39268b8ee4527e935075aa6b6ebe4b63d209906
|
|
BLAKE2b-256 checksum How to use checksums |
a96ee3c463b3e3c55f0a7a8c5790da3f98ac7f1adbe09431ba9d53ccc72131c6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.18 {"installer":{"name":"uv","version":"0.12.18","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}
|
Release files / agentic_kanban-1.5.0-py3-none-macosx_10_12_x86_64.whl
| Download URL | agentic_kanban-1.5.0-py3-none-macosx_10_12_x86_64.whl |
|---|---|
| Size | 16.0 MB |
| Tags | Python 3 macOS 10.12+ x86-64 |
|
SHA-256 checksum How to use checksums |
8ff765bce3d92d71bd8ffb01d33db1f4f40d82af68ab325a4d5fc99f1919c22f
|
|
BLAKE2b-256 checksum How to use checksums |
deca14f282039539393d8a86cb4736d1fe8e44a446fbff1aac6de2f8c5e10cd5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.18 {"installer":{"name":"uv","version":"0.12.18","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}
|
Release files / agentic_kanban-1.5.0-py3-none-any.whl
| Download URL | agentic_kanban-1.5.0-py3-none-any.whl |
|---|---|
| Size | 15.9 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f917b6b05e46bcc51e5b546e2a1e61795ff8d73e951b29f4f9df54009e41acbd
|
|
BLAKE2b-256 checksum How to use checksums |
dcf50541cf7e79fcc27021ac693fc02506ff91902160b7da5154d1ef6c1ce743
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.18 {"installer":{"name":"uv","version":"0.12.18","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}
|
