---
title: "Vibe-Kanban"
type: concept
tags: [vibe-coding, kanban, opencode, ubuntu, ai-pair-programming]
last_updated: 2026-04-15
---

## Definition
AI 结对编程任务看板，通过 Web UI（PORT 9999）管理编程任务，自动 spawn OpenCode Executor 在随机端口执行 AI 编程。

## Core Mechanism
- 启动：RUST_LOG=debug HOST=0.0.0.0 PORT=9999 npx vibe-kanban
- 自动 spawn：vibe-kanban 启动后自动 spawn executor（随机端口），无需手动启动
- 工作目录：/var/tmp/vibe-kanban/worktrees/（需 shenwei 用户权限）
- 配置目录：~/.vibe-kanban
- 清理：rm -rf /var/tmp/vibe-kanban/worktrees/* ~/.vibe-kanban（解决权限/端口问题）

## Key Constraints
- 不要用 root 启动 OpenCode serve
- I/O error 通常是 executor 没启动或端口被占用
- executor 随 vibe-kanban 进程一起管理，不单独用 pm2 管理

## Connections
- [[Vibe-Kanban]] ← spawns ← [[OpenCode Executor]]
- [[nvm]] ← 提供 Node ← [[Vibe-Kanban]]
- [[pm2]] ← 管理进程 ← [[Vibe-Kanban]]