# Kanban CLI

> Self-hosted, open-source (AGPL-3.0) Rust CLI that runs agile task, sprint, role and metrics tracking entirely in local JSON files, with agent-friendly JSON output.

- **Category:** [Kanban](https://selfhost.directory/kanban)
- **Source model:** Open source
- **Author:** hydrafog
- **Platforms:** Nix, Cargo
- **Tags:** Git, Project Management, Terminal, CLI, Ai Agents, Task Management, Kanban, JSON, Local First, Agile, Rust, Sprint Planning

## What is Kanban CLI?

Kanban CLI is a terminal project-management tool aimed at developers who work alongside AI coding agents. It keeps a full agile workflow in JSON files inside a `.kanban/` folder at the project root: tasks with an eight-state lifecycle, sprints with story-point capacity and velocity, a pool of role personas, and per-task, per-role and per-sprint metrics. Every command prints machine-readable JSON by default so an agent can claim a task and receive the role's persona and instructions, while people can opt into table output with a `--human` flag; `kb board` renders the board and `kb task search` queries it. Built-in maintenance covers data validation plus a recalibration pass that checks structural integrity, migrates old files, refreshes statistics, rebalances sprint load and archives finished tasks. Concurrency comes from atomic writes and a two-tier advisory locking scheme (project-wide and per-file), so several agents can touch different tasks at once. Install the Rust binary with Cargo (`cargo install --path .`) or run it straight from source with Nix; the tool reports on the surrounding Git repository but ships no daemon, port or web interface.

## Should you self-host Kanban CLI?

Kanban CLI scores **46/100** on selfhost.directory ([how scoring works](https://selfhost.directory/scoring)) and ranks **#6 of 7** in [Kanban](https://selfhost.directory/kanban).

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is easy: most people get it running in one sitting.

Its closest alternative on selfhost.directory is [Kanboard](https://selfhost.directory/project/kanboard) (69/100, 9 961 stars). It scores higher overall, so compare the two before you pick. [See Kanban CLI vs Kanboard side by side.](https://selfhost.directory/compare/kanban-vs-kanboard)

## Features

- Acceptance criteria
- Agent task claiming
- Automated recalibration
- Concurrent access locking
- Data Validation
- Human-only completion gate
- JSON output by default
- Kanban Board View
- Local JSON file storage
- Project metrics
- Role pool assignment
- Sprint planning
- Task search
- Task state machine
- Velocity tracking

## How to install Kanban CLI

### Install Kanban CLI with Nix

You can run Kanban CLI directly from the source without installation:
```bash
nix run github:hydrafog/kanban -- --help
```

Note: Flake-based run straight from the repository; `nix develop` provides a shell with Rust and Cargo.

### Install Kanban CLI with Cargo

You can install `kb` directly using Cargo:

```bash
cargo install --path .
```

Or for a production-ready build:

```bash
cargo build --release
cp target/release/kanban /usr/local/bin/kb
```

Note: Rust package manager install from the repository source.

## Kanban CLI alternatives

- [helloam-agentic-kanban](https://selfhost.directory/project/helloam-agentic-kanban): AM is a self-hosted, open-source AI agent that runs locally, using a kanban board to autonomously execute tasks with persistent memory and git-backed audit trails. (compare: https://selfhost.directory/compare/helloam-agentic-kanban-vs-kanban)
- [taskboard](https://selfhost.directory/project/taskboard): Self-hosted Kanban tool for developers with built-in terminal and AI assistant integration via MCP. One executable, SQLite storage, zero dependencies. (compare: https://selfhost.directory/compare/kanban-vs-taskboard)
- [KanVibe](https://selfhost.directory/project/kanvibe): KanVibe is a self-hosted desktop Kanban board that manages AI coding agents through git worktrees and embedded terminals with automatic hook-driven task tracking. (compare: https://selfhost.directory/compare/kanban-vs-kanvibe)
- [Kan.bn](https://selfhost.directory/project/kanbn): The open source Trello alternative. (compare: https://selfhost.directory/compare/kanban-vs-kanbn)
- [kan](https://selfhost.directory/project/kan): An open-source Trello alternative for self-hosted kanban boards: workspaces, labels, comments, activity logs, Trello imports and a REST API, run via Docker Compose. (compare: https://selfhost.directory/compare/kan-vs-kanban)
- [kandev](https://selfhost.directory/project/kandev): Self-hosted open-source platform to run and coordinate multiple AI coding agents with kanban boards, integrated workspace, and review gates. (compare: https://selfhost.directory/compare/kanban-vs-kandev)
- [clawdeck](https://selfhost.directory/project/clawdeck): Open-source Rails kanban for OpenClaw AI agents: boards, live activity feed, REST API. The hosted site is ending, but self-hosted installs from the repo keep working. (compare: https://selfhost.directory/compare/clawdeck-vs-kanban)
- [Kanboard](https://selfhost.directory/project/kanboard): Self-hosted, open-source Kanban task board for teams: WIP limits, swimlanes, automatic actions, subtasks and time tracking, with LDAP or OAuth2 logins. (compare: https://selfhost.directory/compare/kanban-vs-kanboard)

## More in Kanban

- [Kanboard](https://selfhost.directory/project/kanboard): Self-hosted, open-source Kanban task board for teams: WIP limits, swimlanes, automatic actions, subtasks and time tracking, with LDAP or OAuth2 logins.
- [Kaneo](https://selfhost.directory/project/kaneo): Open-source, self-hosted project tracker for teams: kanban boards, Gantt and calendar views, a backlog, time tracking, and free single sign-on via OAuth or OIDC.
- [KittyClaw](https://selfhost.directory/project/kittyclaw): Self-hosted kanban where AI agents (Claude, Codex, Grok, Mistral, Ollama) work alongside humans with pipelines, processors, live streaming, and MCP server.
- [Leantime](https://selfhost.directory/project/leantime): Self-hosted, open-source project management system with kanban, gantt, sprints, timesheets, wikis and goals, built around ADHD, dyslexia and autism.
- [OpenProject](https://selfhost.directory/project/openproject): Self-hosted, open-source project management tool: Gantt timelines, Scrum and Kanban boards, time and cost reports, wikis, meetings and forums.
- [OverClick](https://selfhost.directory/project/overclick): OverClick is a self-hosted, open-source Kanban board for hybrid human-AI teams where AI agents claim and execute tasks via MCP, reporting token usage and time per card.
- [paca](https://selfhost.directory/project/paca): Self-hosted and open-source Scrum tooling: AI agents share the board and the sprint with people, plus IAM-style role policies and WASM plugins.
- [planka](https://selfhost.directory/project/planka): Elegant open source project tracking. Self-hosted Kanban for teams — free Community edition, with PLANKA Pro for organisations.
- [taskcafe](https://selfhost.directory/project/taskcafe): Taskcafe is an open-source, self-hosted project management tool built around Kanban boards, with teams, personal projects, labels, checklists and task activity.
- [Tasks.md](https://selfhost.directory/project/tasksmd): A self-hosted, open-source Kanban board that stores tasks as Markdown files on disk. Runs in a single Docker container with PWA support, dark mode, and multilingual UI.
- [Ticky](https://selfhost.directory/project/ticky): Self-hosted open-source Kanban board with projects, time tracking, labels, attachments, reminders, dark mode, and offline operation.
- [trello-clone-laravel-8-open-source](https://selfhost.directory/project/trello-clone-laravel-8-open-source): Self-hosted Laravel 8 project management tool cloning Trello with Jalali, Gregorian, and Hijri calendars, admin panels, and role-based access.

## Links

- [Homepage](https://codeberg.org/hydrafog/kanban)

---
Source: https://selfhost.directory/project/kanban