Skip to main content

Agentic Kanban

Test status Deploy Status Docs Go Reference PyPI

A kanban board for managing AI agent sessions.

Each ticket is bound to an agent session (Claude Code, pi.dev, opencode, Antigravity CLI) 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, opencode, Antigravity CLI), 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/.config/opencode:$HOME/.config/opencode \
  -v $HOME/.local/share/opencode:$HOME/.local/share/opencode \
  -v $HOME/.gemini:$HOME/.gemini \
  -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.

Metadata

Release files for agentic-kanban 1.11.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distributions (wheels)

Table of built distributions (wheels) for agentic-kanban 1.11.0
File Actions
agentic_kanban-1.11.0-py3-none-win_arm64.whl Python 3 none Windows ARM64 Details for agentic_kanban-1.11.0-py3-none-win_arm64.whl
agentic_kanban-1.11.0-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details for agentic_kanban-1.11.0-py3-none-win_amd64.whl
agentic_kanban-1.11.0-py3-none-manylinux_2_17_x86_64.whl Python 3 none Linux glibc 2.17+ x86-64 Details for agentic_kanban-1.11.0-py3-none-manylinux_2_17_x86_64.whl
agentic_kanban-1.11.0-py3-none-manylinux_2_17_aarch64.whl Python 3 none Linux glibc 2.17+ ARM64 Details for agentic_kanban-1.11.0-py3-none-manylinux_2_17_aarch64.whl
agentic_kanban-1.11.0-py3-none-macosx_11_0_x86_64.whl Python 3 none macOS 11.0+ x86-64 Details for agentic_kanban-1.11.0-py3-none-macosx_11_0_x86_64.whl
agentic_kanban-1.11.0-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details for agentic_kanban-1.11.0-py3-none-macosx_11_0_arm64.whl
agentic_kanban-1.11.0-py3-none-any.whl Python 3 none any Details for agentic_kanban-1.11.0-py3-none-any.whl

Total release size: 125.9 MB

Release files / agentic_kanban-1.11.0-py3-none-win_arm64.whl

Download URL agentic_kanban-1.11.0-py3-none-win_arm64.whl
Size 17.2 MB
Tags Python 3 Windows ARM64
SHA-256 checksum
How to use checksums
17108095f48dc087e404ce07e3f0c347345ece513ffde9cd24f02d0286369b6a
BLAKE2b-256 checksum
How to use checksums
89574b781246db04f5b5f44abb2cbac5386885797696bc3f40054ecfaa325825
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.9 {"installer":{"name":"uv","version":"0.13.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","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.11.0-py3-none-win_amd64.whl

Download URL agentic_kanban-1.11.0-py3-none-win_amd64.whl
Size 18.5 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
6e5fb35afa3a9baf8b14b81c03fbb9c74dfc9d0bd70a7392d5bf6249e8aaa7c5
BLAKE2b-256 checksum
How to use checksums
b8dc9fee840487c53063902fa9acef392038de1421501d7b39a81440c989ff6a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.9 {"installer":{"name":"uv","version":"0.13.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","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.11.0-py3-none-manylinux_2_17_x86_64.whl

Download URL agentic_kanban-1.11.0-py3-none-manylinux_2_17_x86_64.whl
Size 18.4 MB
Tags Linux glibc 2.17+ x86-64 Python 3
SHA-256 checksum
How to use checksums
56f2e34ff7fab19ba53a9c58b65cd9320c34af8ebd457fd37751e91cc978a6b1
BLAKE2b-256 checksum
How to use checksums
e6fa6c369133369f7b0a1133a99770012c6d1d450209cd6a52cb1bfe54961539
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.9 {"installer":{"name":"uv","version":"0.13.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","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.11.0-py3-none-manylinux_2_17_aarch64.whl

Download URL agentic_kanban-1.11.0-py3-none-manylinux_2_17_aarch64.whl
Size 17.2 MB
Tags Linux glibc 2.17+ ARM64 Python 3
SHA-256 checksum
How to use checksums
1aa4195d601c0c9312bcdffa12045aad0c7d6b67fef4fb603cc0c74166f555fd
BLAKE2b-256 checksum
How to use checksums
20cf76d8646c9e9828b8fabe6300a5e27f19b6aaf29c919c13e8911e1a6a92f1
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.9 {"installer":{"name":"uv","version":"0.13.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","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.11.0-py3-none-macosx_11_0_x86_64.whl

Download URL agentic_kanban-1.11.0-py3-none-macosx_11_0_x86_64.whl
Size 18.4 MB
Tags Python 3 macOS 11.0+ x86-64
SHA-256 checksum
How to use checksums
092e9b2424d0c4765e89854c1d5d4f98b68fbfb0aa100047a6ffbf8449418486
BLAKE2b-256 checksum
How to use checksums
28008d26587044160e3da99588159879ae53b7fab5d8884326bab07cc670a0be
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.9 {"installer":{"name":"uv","version":"0.13.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","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.11.0-py3-none-macosx_11_0_arm64.whl

Download URL agentic_kanban-1.11.0-py3-none-macosx_11_0_arm64.whl
Size 17.8 MB
Tags Python 3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
27a0003e5cab9efcee2090d22274979c1816bd418669c075b1b0a5313fbeb46a
BLAKE2b-256 checksum
How to use checksums
b5d8edd15e30a75e0e41413f522405c6f7666e5efd6f056e109475845d15b289
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.9 {"installer":{"name":"uv","version":"0.13.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","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.11.0-py3-none-any.whl

Download URL agentic_kanban-1.11.0-py3-none-any.whl
Size 18.4 MB
Tags Python 3
SHA-256 checksum
How to use checksums
94223d555abdc6122eab2990b998656275515845c2692ead3bc3a43c70c68f9c
BLAKE2b-256 checksum
How to use checksums
1dea12a555a635834b1e28d68bbfacafcfc59184b4cdcf5103c9bbab900a1686
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.9 {"installer":{"name":"uv","version":"0.13.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for agentic-kanban 1.11.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.11.0 This release

7 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page