Open source · MIT License

One board.
Multiple agents.
No conflicts.

A file-based Kanban CLI for multi-agent workflows. AI agents coordinate through atomic claims, Markdown task files, and token-efficient output. No database, no server — just a single binary.

$ brew install antopolskiy/tap/kanban-md
kanban-md terminal UI showing a board with tasks across columns

Interactive TUI

A full terminal board you can run alongside your agents. Keyboard-driven navigation, live file-watching, progressive age colors, and multi-agent claim visibility — all without leaving the terminal.

Live reload Board updates as agents modify task files on disk
Age colors Tasks change color based on time in current status
Agent claims See which agent owns each task at a glance
kanban-md tui interactive terminal board showing tasks across status columns with agent claims and age colors
$ brew install antopolskiy/tap/kanban-md

Multi-agent safe

The pick --claim command atomically finds, claims, and moves the next task. No two agents work on the same thing.

Plain Markdown

Every task is a .md file with YAML frontmatter. Grep it, diff it, track it in git. No database, no server.

Token-efficient

The --compact format uses 70% fewer tokens than JSON. Designed for agent context windows.

Quick start

# Initialize a board
$ kanban-md init --name "My Project"

# Create tasks
$ kanban-md create "Set up CI pipeline" --priority high
$ kanban-md create "Fix login bug" --priority critical

# Agent claims the next task atomically
$ kanban-md pick --claim agent-1 --move in-progress

# Token-efficient output
$ kanban-md list --compact
#1 [in-progress/high] Set up CI pipeline @agent-1
#2 [backlog/critical] Fix login bug

# Done
$ kanban-md move 1 done

Features

Interactive TUI

Full terminal board with keyboard navigation, live-reloading on file changes, and progressive age colors.

Agent skills

Pre-written skills teach Claude Code and other agents how to use the board. Install with kanban-md skill install.

Flow metrics

Cycle time, throughput, lead time, and aging work items. Built in, not bolted on.

Classes of service

Expedite, fixed-date, standard, intangible — with per-class WIP limits and pick priority.

Archive & soft-delete

Archive tasks instead of deleting them. Hidden by default, still satisfy dependencies.

Zero dependencies

Single static binary. Works anywhere Go compiles to. macOS, Linux, Windows.

Install

Homebrew
brew install antopolskiy/tap/kanban-md
Go
go install github.com/antopolskiy/kanban-md/cmd/kanban-md@latest
Binary

Download from GitHub Releases