agent-kanban
Home/Getting started

Installation guide

Getting started with Agent Kanban PM

Launch a local Kanban control plane for your coding agents, create a project, and move your first task from plan to reviewed change. The software is free forever, open source, and runs on your machine.

What you need

Agent Kanban PM supports Python 3.11 or newer on Linux and macOS. Windows users can run it through WSL. You also need Git and at least one command-line coding agent such as Claude Code, Codex, OpenCode, Aider, or Antigravity CLI. Tmux is recommended for detachable sessions but is not required.

Run it without installing

The quickest start uses uvx. It downloads the published Python package into an isolated environment and starts the local server:

uvx agent-kanban-pm
# Open the URL printed in your terminal,
# normally http://127.0.0.1:8000

Your board, tasks, agent sessions, and review evidence stay local. The server is designed for one trusted operator; do not expose it to an untrusted network.

Install a persistent command

If you want the agent-kanban command available every day, install it with uv tool or pipx:

uv tool install agent-kanban-pm
agent-kanban

# Or:
pipx install agent-kanban-pm
agent-kanban
Free forever means free forever.

There is no paid tier, account requirement, hosted dependency, trial limit, or usage fee. Agent Kanban PM is released under the MIT license.

Your first four steps

  1. Create a project. Point it at a Git repository you want your agents to work in.
  2. Add a task. Write the objective, acceptance criteria, and useful context just as you would for a human contributor.
  3. Assign and launch. Choose an installed CLI agent. Agent Kanban PM keeps the run attached to the task and can isolate work in a Git worktree.
  4. Review the evidence. Inspect output, diffs, tests, commits, and approval gates before accepting the result.

Choose how agents connect

Local agents can work through the browser-managed runtime, the command-line interface, a REST API, or the MCP server. The board remains the shared source of truth whichever surface you choose. Read the integration guide for supported agent CLIs and connection options.

Build from source

Contributors can clone the repository and use the locked development environment:

git clone https://github.com/Raman369AI/agent-kanban-pm.git
cd agent-kanban-pm
uv sync --locked
uv run agent-kanban

For architecture, security boundaries, and development commands, continue to the project README and contributor documentation on GitHub.

View on PyPI Read the README