selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Codeberg

Self-host Kanban CLI

Terminal kanban and sprint tracker for AI coding agents

Open Source
Updated5 months ago
Setup difficultyEasy
Install with Nix
Terminal board view of the kanban boardTask list table rendered in the terminalSprint list view in the terminal

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) and ranks #6 of 7 in 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 (69/100, 9 961 stars). It scores higher overall, so compare the two before you pick. See Kanban CLI vs Kanboard side by side.

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:

nix run github:hydrafog/kanban -- --help

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

How to configure Kanban CLI

  • project_nameConfiguration key (string) for the name of the project, changed with `kb project config set`.

    values: string

  • sprint_length_daysConfiguration key (integer) setting the default duration for new sprints.

    values: integer

  • min_tasks_per_sprintInteger threshold for the minimum number of tasks considered healthy for a sprint.

    values: integer

  • max_tasks_per_sprintInteger threshold for the maximum number of tasks considered healthy for a sprint.

    values: integer

  • min_sprint_title_length5Shortest allowed sprint title when validating sprint creation.

    values: integer

More in Kanban

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…