Open source · MIT License

Kanban for
AI agents

CLI-first task management built for automation. Agents get deterministic JSON output. Humans get a web dashboard. Runs on local SQLite or Linear.

localhost:3000
agent-kanban web dashboard showing kanban board with columns and task cards

Web dashboard — real-time board with WebSocket updates

Capabilities

Built for agents,
usable by humans

CLI-first JSON output

Every command returns a structured JSON envelope. Deterministic, parseable, scriptable. Pass --pretty for human-readable output.

Real-time web dashboard

Interactive kanban board with WebSocket push updates. Filter by assignee, project, or priority. Works on desktop and mobile.

Dual provider backends

Run locally with SQLite for zero-config setup, or connect to Linear for team-scale issue tracking with the same CLI interface.

Task management

Add, move, assign, prioritize, and bulk-operate on tasks. Full CRUD with column management, activity logging, and metrics.

Agent integration

Structured error codes, consistent exit codes, and JSON envelopes make it trivial for AI agents to create, update, and track work.

Docker ready

Ship as a single container. Mount a volume for SQLite persistence or pass Linear credentials as env vars. Deploy anywhere.

Interface

Bash is the API

Terminal
# Initialize a board
$ kanban board init
{ "ok": true, "data": { "columns": ["recurring","backlog","in-progress","review","done"] } }

# Add a task with priority and assignee
$ kanban task add "Set up CI pipeline" -p high -a alice
{ "ok": true, "data": { "id": "t_k7x2m", "title": "Set up CI pipeline", "priority": "high" } }

# Move tasks through the board
$ kanban task move t_k7x2m in-progress
{ "ok": true, "data": { "id": "t_k7x2m", "column": "in-progress" } }

# View the board (human-friendly)
$ kanban board view --pretty

  BACKLOG (1)          IN-PROGRESS (1)      REVIEW (0)           DONE (0)
  ─────────────        ─────────────────    ──────────           ────────
  Write tests          Set up CI pipeline
  medium               high · alice


# Start the web dashboard
$ kanban serve
Server running at http://localhost:3000

Backends

Choose your provider

Default

Local SQLite

Zero-config, file-based storage with WAL mode. Everything runs locally.

  • Full CRUD operations
  • Column management
  • Activity log & metrics
  • Bulk operations
  • Board configuration

Team scale

Linear

Sync with your Linear workspace. Same CLI interface, team-scale backend.

  • Create & update tasks
  • Move tasks between states
  • External refs (TEAM-123)
  • Direct issue URLs
  • Team sync via API

Works on mobile

The web dashboard adapts to any screen. Collapsible grouped lists replace the kanban grid on smaller viewports.

agent-kanban mobile view showing grouped task list

Get started

Install globally with Bun and start managing tasks in seconds.