A local-first, agent-first CLI for software development workflows.

  • Rust 97.8%
  • Python 1.4%
  • Nix 0.8%
2026-05-23 19:17:22 +03:00
.agents/skills/kanban feat: auto-detect files_to_modify from git merge-base diff 2026-05-20 13:44:27 +03:00
.benchmarks chore: align structure, optimize performance, and split commands 2026-05-22 17:24:46 +03:00
assets docs: update demo gifs with populated data 2026-05-12 13:39:53 +03:00
docs feat: implement codebase optimization and logic patches 2026-05-18 19:02:35 +03:00
src feat(recalibrate): generic schema self-healing upgrades 2026-05-23 19:17:22 +03:00
tests feat(recalibrate): generic schema self-healing upgrades 2026-05-23 19:17:22 +03:00
.envrc docs: complete system architecture and reference documentation 2026-04-06 15:31:42 +03:00
.gitignore chore: untrack .agents/artifacts directory 2026-05-18 19:11:25 +03:00
.markdownlint.json feat: add project templates and expand test coverage 2026-04-14 21:27:42 +03:00
AGENTS.md feat: auto-detect files_to_modify from git merge-base diff 2026-05-20 13:44:27 +03:00
Cargo.lock refactor: thermo-nuclear audit deduplication, version bump to 3.6.0 2026-05-22 14:44:40 +03:00
Cargo.toml refactor: thermo-nuclear audit deduplication, version bump to 3.6.0 2026-05-22 14:44:40 +03:00
flake.lock chore: align structure, optimize performance, and split commands 2026-05-22 17:24:46 +03:00
flake.nix chore: align structure, optimize performance, and split commands 2026-05-22 17:24:46 +03:00
lefthook.yml chore: align structure, optimize performance, and split commands 2026-05-22 17:24:46 +03:00
LICENSE chore: change license to agpl-3.0 2026-05-06 20:50:27 +03:00
README.md feat: codebase transition from python to rust 2026-05-12 12:40:14 +03:00
rustfmt.toml chore: align structure, optimize performance, and split commands 2026-05-22 17:24:46 +03:00

Kanban CLI

License: AGPL v3 Rust 1.75+ Codeberg

A local-first, agent-first CLI for software development workflows.

Kanban CLI is a terminal-based project management tool that brings agile workflows directly to your local file system. Designed with AI agents in mind, it provides structured task tracking, sprint management, and role-based assignments using a git-integrated, JSON-backed architecture.

Demos

Task List

Task List Demo

Sprint List

Sprint List Demo

Board View

Board View Demo

Documentation Index

Getting Started

Document Description
Installation Nix and Cargo setup guides
Configuration Project initialization, templates, and environment
Quickstart Initialize a project, create a task, assign a role, claim, and complete

Concepts

Document Description
Tasks State machine, acceptance criteria, dependencies, and revisions
Sprints Lifecycle, scope creep, velocity, and assignments
Roles Role Pool system, task-to-role assignment, and claim workflow
Statistics Tracked metrics and recalibration engine overview

Architecture

Document Description
Architecture Layered architecture, data flow, and concurrency model
High-Level Architecture Designing for agents, layers, and command groups
Data Model Complete JSON schemas for Task, Role, Agent, Sprint, and Config
Storage File layout, atomic writes, file locking, and migrations
Project Structure Directory layout and module organization

Reference

Document Description
CLI Commands Complete command reference for task, role, sprint, agent, stats, and recalibrate
JSON Output Standard output wrapper, enriched responses, and error format
Role Pool Built-in roles, custom role schema, and usage examples
Statistics Guide Formulas, confidence score calculation, and aggregation algorithms

Development

Document Description
Coding Style Rust conventions, Serve patterns, Clap patterns, and naming

Operations

Document Description
Recalibration Operations Running recalibration, reviewing results, and managing suggestions

Quick Links