name: vibekanban
description: "Vibe Kanban orchestration platform for AI coding agents: workspaces, sessions, task management, code review, git worktrees, multi-agent support. Keywords: Vibe Kanban, AI agents, Claude Code, Codex, Gemini, kanban board, git worktree, code review, MCP server, workspaces, sessions."
version: "0.0.162"
release_date: "2026-01-26"

Vibe Kanban

Orchestration platform for AI coding agents. Plan, review, and manage AI-generated code in isolated git worktrees.

Quick Navigation

Quick Start

Install & Run

npx vibe-kanban

Opens browser automatically. Use PORT=8080 npx vibe-kanban for fixed port.

Prerequisites

• Node.js LTS
• Authenticated coding agent (Claude Code, Codex, Gemini, etc.)
• GitHub CLI (gh) for PR integration

First Steps

1. Authenticate with a coding agent externally
2. Run npx vibe-kanban
3. Complete setup dialogs
4. Create project from existing git repo
5. Add tasks and start executing

Two UI Modes

Classic Kanban (Tasks)

Traditional board with columns: To do → In Progress → In Review → Done

Workspaces (Beta) — NEW

Modern interface with:

• Sessions: Multiple conversation threads per workspace
• Command Bar: Cmd/Ctrl + K for all actions
• Workspace Notes: Document requirements and decisions
• Multi-repo support: Work across multiple repositories
• Integrated Terminal: PTY-backed terminal with shell support

Switch between modes via Command Bar → "Open in Old UI"

Core Concepts

Git Worktrees

Each task/workspace runs in an isolated git worktree:

• Agents can't interfere with each other
• Safe from main branch changes
• Automatic cleanup after completion

Task Flow (Classic)

To do → In Progress → In Review → Done

• To do: Task created
• In Progress: Agent executing
• In Review: Agent finished, awaiting review
• Done: Merged or PR merged

Task Attempts

One task can have multiple attempts:

• Different agent
• Different branch
• Fresh conversation context

Supported Agents

Select agent when creating task attempt or workspace session.

Project Configuration

Setup Scripts

Run before agent execution (e.g., npm install, cargo build).

Dev Server Scripts

Start dev server for preview (e.g., npm run dev).

Cleanup Scripts

Run after agent finishes (e.g., npm run format).

Copy Files

Files to copy from main project to worktree (e.g., .env).

Task Creation

Press C or click + to create task

Options:

• Create Task: Add to board only
• Create & Start: Add and immediately execute with default agent

Task Tags

Reusable snippets via @mention:

• Type @ in description
• Select tag from dropdown
• Content inserted at cursor

Code Review

1. Task moves to "In Review" when agent finishes
2. Click Diff icon to view changes
3. Click + on any line to add comment
4. Submit all comments together
5. Task returns to "In Progress" for fixes

Git Operations

Preview Mode

Test web apps without leaving Vibe Kanban:

1. Configure dev server script in project settings
2. Click "Start Dev Server" in Preview tab
3. View app in embedded iframe
4. Install vibe-kanban-web-companion for component selection

Keyboard Shortcuts

MCP Integration

Add MCP Servers to Agents

Settings → MCP Servers → Select agent → Add servers

Vibe Kanban MCP Server

Expose Vibe Kanban to external MCP clients:

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

MCP tools: list_projects, list_tasks, create_task, start_task_attempt

Critical Safety Note

Vibe Kanban runs agents with --dangerously-skip-permissions/--yolo by default for autonomous operation. Each task runs in isolated worktree, but agents can still perform system-level actions. Review work and keep backups.

Critical Prohibitions

• Do not skip agent authentication before first use
• Do not ignore worktree isolation benefits
• Do not forget to configure setup/cleanup scripts for dependencies
• Do not mix multiple agents on same task without new attempts
• Do not ignore rebase conflicts — resolve or abort

Links

• Official docs: https://www.vibekanban.com/docs
• Vibe Guide: https://www.vibekanban.com/vibe-guide
• GitHub: https://github.com/BloopAI/vibe-kanban