vibe-kanban

star 6

Local kanban board for AI agents. Agents create/update/complete tasks, track status visually. Use when: manage tasks, kanban, create task, update status, task board.

qwwiwi By qwwiwi schedule Updated 4/9/2026

name: vibe-kanban description: "Local kanban board for AI agents. Agents create/update/complete tasks, track status visually. Use when: manage tasks, kanban, create task, update status, task board." user-invocable: true argument-hint: "[action] [task-description]"

Vibe Kanban -- Task Board for Agents

Local kanban board with browser UI. Agents create tasks, change statuses, manage workspaces. Each task gets its own git worktree and branch.

Setup

npx vibe-kanban

Opens in browser. No database, no cloud -- runs locally with SQLite.

How Agents Use It

Through MCP (recommended)

Vibe Kanban has a built-in MCP server. Add to your .mcp.json:

{
  "mcpServers": {
    "vibe-kanban": {
      "command": "npx",
      "args": ["-y", "vibe-kanban", "mcp"]
    }
  }
}

Agent gets these tools:

  • list_workspaces -- see all tasks and their statuses
  • create_session -- start working on a task
  • run_session_prompt -- execute work in a task's workspace
  • get_execution -- check execution status

Through CLI

# Start the board
npx vibe-kanban

# Open in browser
# http://localhost:<port> (auto-assigned)

Task Lifecycle

Todo  -->  InProgress  -->  InReview  -->  Done
                |
                v
           Cancelled
Status Meaning
Todo Task created, waiting to start
InProgress Agent is working on it
InReview Work done, needs review
Done Completed and merged
Cancelled Abandoned

Multi-Agent Workflow

Multiple agents can share the same kanban board:

  1. One board per project -- all agents see the same tasks
  2. Each task = git worktree -- agents work in isolation
  3. Status updates in real-time -- visible in browser UI
  4. Code review built-in -- inline comments on diffs

Example: 3-agent team

Agent Role How they use kanban
Coordinator Assigns tasks Creates tasks, sets priorities
Coder Implements Picks tasks, moves to InProgress, submits to InReview
Reviewer Reviews code Reviews InReview tasks, approves or requests changes

Features

Feature Description
Git worktrees Each task gets isolated worktree + branch
Browser UI Drag-and-drop kanban board
Code review Inline diff comments
PR creation Create GitHub PR from completed task
Auto-cleanup Worktrees deleted 72h after completion
MCP integration AI agents manage tasks programmatically

Supported AI Agents

Claude Code, Codex, Gemini CLI, Amp, Cursor, OpenCode, QwenCode, Copilot, Droid.

Reference

Install via CLI
npx skills add https://github.com/qwwiwi/public-architecture-claude-code --skill vibe-kanban
Repository Details
star Stars 6
call_split Forks 1
navigation Branch main
article Path SKILL.md
More from Creator