kanban

# Keyboard-first kanban
for the terminal.

Intuitive TUI. Powerful CLI. 40-tool MCP server.
Your data lives in a file on your disk — private, offline, always yours.

    $ cargo install kanban-cli

- Zero latency — pure keyboard flow, hjkl navigation, no mouse required
- Your data, your disk — JSON or SQLite file, private, offline, always accessible
- Git-native — generate branch names and `git checkout` commands from any card
- LLM-native — 40-tool MCP server works with Claude Code, Cursor, and any MCP client
- Offline-first — atomic writes, live conflict detection, works anywhere

## Features

### Keyboard-driven

hjkl navigation, vim-style `/` search, jump motions with `gg`/`G`, half-page scroll with `{`/`}`, context-aware shortcuts, and 100-level undo/redo.

### Three interfaces

TUI for interactive work. CLI for scripting — all operations, JSON output, pagination. MCP server with 40 tools for LLM integration with Claude Code and Cursor.

### Git-native workflow

Press `y` to copy a git branch name, `Y` to copy the full `git checkout` command. Card prefixes map to branch names — `KAN-42/fix-the-bug`.

### Sprint planning

Full sprint lifecycle: Planning → Active → Completed. Carry uncompleted cards forward with one key. Per-sprint card prefix overrides, assignment history tracked per card.

### Rich cards

Priority levels, status, story points, due dates, markdown descriptions, parent/child dependencies with cycle detection, bulk operations, archive and restore.

### Local-first storage

JSON (default) or SQLite — switch by file extension. Atomic writes, live file watching, conflict detection when multiple instances write concurrently. No cloud, no account.

## Getting Started

### From Crates.io

    $ cargo install kanban-cli

### Using Nix

    $ nix run github:fulsomenko/kanban
    $ # or
    $ nix run github:nixos/nixpkgs/nixpkgs-unstable#kanban

### Arch Linux (AUR)

    $ yay -S kanban

### From Source

    $ git clone https://github.com/fulsomenko/kanban
    $ cd kanban
    $ cargo install --path crates/kanban-cli

## Roadmap

Version @VERSION@

### Completed

- [x] Progressive auto-save
- [x] Full CLI interface matching TUI operations
- [x] Card dependencies (parent-child and blocking)
- [x] Undo/redo support
- [x] MCP server for LLM integration
- [x] Multiple storage backends (JSON, SQLite)

### Planned

- [ ] Attachments, adding files to cards
- [ ] HTTP API for remote board access
- [ ] Collaborative features (multi-user, sync)
- [ ] Web UI to complement TUI and CLI
- [ ] Configurable keybindings
- [ ] Audit log for compliance tracking