Vibe Kanban Quick Start

Quick reference for using Vibe Kanban with managing-apps.

Installation

No installation needed! Vibe Kanban runs via npx.

Starting Vibe Kanban

From Projects folder (recommended - manages all projects):

cd /Users/oda/Desktop/Projects
npm run vibe-kanban

Or directly:

cd /Users/oda/Desktop/Projects
npx vibe-kanban

Alternative: From managing-apps folder (project-specific):

cd /Users/oda/Desktop/Projects/managing-apps
npx vibe-kanban

First Time Setup

Start Vibe Kanban:
```
npm run vibe-kanban
```
Complete setup dialogs:
- Configure your coding agent (Claude, Codex, etc.)
- Set editor preferences
- Configure GitHub integration (optional)
Access the UI:
- Vibe Kanban will print a URL in the terminal
- Usually: http://localhost:3000 (or random port)
- Automatically opens in your default browser

Configuration

Project-specific configuration is in .vibe-kanban/config.json:

MCP Servers: dev-manager-mcp integration
QA Automation: Auto-start dev environments
Task Statuses: Configure when to auto-start environments

Using with Dev Environments

When a task moves to "Ready for QA":

Vibe Kanban automatically calls scripts/start-task-docker.sh
Creates isolated Docker environment
Copies database from main repo
Provides test URLs
When done, automatically stops the environment

Commands

# Start Vibe Kanban
npm run vibe-kanban

# Start dev-manager-mcp daemon (in separate terminal)
npm run dev-manager:start

# Check dev-manager status
npm run dev-manager:status

# Start dev environment manually
npm run dev-env:start

# Stop dev environment
npm run dev-env:stop TASK-123

Fixed Port

To use a fixed port:

PORT=8080 npm run vibe-kanban

2.0 KiB Raw Blame History