Vibe Kanban：用看板编排 Claude Code、Codex 等多个编码 Agent 的开源工具
Vibe Kanban 是 BloopAI 开源的多编码 Agent 编排工具：用看板（kanban）规划任务，为每个任务创建独立 workspace（含分支、终端、开发服务器），让 Claude Code、Codex、Gemini CLI、GitHub Copilot、Amp、Cursor、OpenCode、Droid、CCR、Qwen Code 等编码 Agent 执行工作，并在界面内审查 diff、留行内评论、预览应用、创建 PR 并合并。一条命令即可启动：npx vibe-kanban。官方页面已公告该项目正在 sunsetting（停止维护）。
社区作者 · zZz
它解决什么问题
Vibe Kanban 面向“软件工程师把大量时间花在规划与审查编码 Agent 产出”这一场景，目标是把规划和审查做得更快。
核心能力（源自仓库说明）：
- 用看板 issue 规划工作：在看板上创建、排序、分配 issue，可私有使用也可团队协作。
- 在 workspace 中运行编码 Agent：每个 workspace 给 Agent 分配一个分支、一个终端和一个开发服务器。
- 审查 diff 并留行内评论：直接把反馈发给 Agent，无需离开界面。
- 预览应用：内置浏览器，带 devtools、inspect 模式和设备模拟。
- 在 10+ 编码 Agent 之间切换：Claude Code、Codex、Gemini CLI、GitHub Copilot、Amp、Cursor、OpenCode、Droid、CCR、Qwen Code。
- 创建并合并 Pull Request：用 AI 生成描述开 PR，在 GitHub 上审查并合并。
配图 1 为 Vibe Kanban Logo；配图 2 为产品总览界面截图；配图 3 为 workspace 界面截图。
使用流程被概括为“一条命令。描述工作、审查 diff、发布。”
npx vibe-kanban。重要提示：页面顶部明确写着 “Vibe Kanban is sunsetting.”（项目正在停止/退役），并指向公告，采用前需评估维护状态。
— 本文由 AI 根据公开来源辅助整理，命令、版本与许可证请在使用前到原始页面复核。
安装 / 开始使用
以下步骤均来自仓库 README，按顺序执行：
一、快速开始（推荐路径）
- 准备环境：先确保你已经用自己常用的编码 Agent 完成登录认证（支持的 Agent 完整列表见官方文档）。
步骤 2 · 在终端运行：
npx vibe-kanban二、本地开发（Development）
- 前置条件：Rust（最新稳定版）、Node.js（>=20）、pnpm（>=8）。
- 安装额外开发工具：
cargo install cargo-watchcargo install sqlx-cli步骤 3 · 安装依赖：
pnpm i步骤 4 · 启动开发服务器：
pnpm run dev说明：该命令会同时启动后端与 Web 应用；一个空白数据库会从 dev_assets_seed 文件夹复制过来。
三、只构建 Web 应用
cd packages/local-webpnpm run build四、从源码构建（macOS）
步骤 1 · 运行：
./local-build.sh步骤 2 · 测试：
cd npx-cli && node bin/cli.js五、环境变量（构建期或运行期可配置）
- POSTHOG_API_KEY（构建期，默认空）：PostHog 分析 API key，为空则关闭分析。
- POSTHOG_API_ENDPOINT（构建期，默认空）：PostHog 分析端点，为空则关闭分析。
- PORT（运行期，默认自动分配）：生产环境为服务端端口；开发环境为前端端口（后端使用 PORT+1）。
- BACKEND_PORT（运行期，默认 0 自动分配）：后端端口，仅开发模式，覆盖 PORT+1。
- FRONTEND_PORT（运行期，默认 3000）：前端开发服务器端口，仅开发模式，覆盖 PORT。
- HOST（运行期，默认 127.0.0.1）：后端服务主机。
- MCP_HOST（运行期，默认取 HOST 的值）：MCP 服务器连接主机（Windows 上 HOST=0.0.0.0 时应使用 127.0.0.1）。
- MCP_PORT（运行期，默认取 BACKEND_PORT 的值）：MCP 服务器连接端口。
- DISABLE_WORKTREE_CLEANUP（运行期，默认未设置）：禁用全部 git worktree 清理（含孤儿与过期 workspace 清理），用于调试。
- VK_ALLOWED_ORIGINS（运行期，默认未设置）：允许调用后端 API 的来源列表，逗号分隔，例如 https://my-vibekanban-frontend.com。
- VK_SHARED_API_BASE（运行期，默认未设置）：本地桌面应用使用的远程/云端 API 基础 URL。
- VK_SHARED_RELAY_API_BASE（运行期，默认未设置）：隧道模式连接使用的 relay API 基础 URL。
- VK_TUNNEL（运行期，默认未设置）：设置后启用 relay 隧道模式（需要 relay API 基础 URL）。
注意：构建期变量必须在执行
pnpm run build 时设置；运行期变量在应用启动时读取。
六、反向代理或自定义域名自托管
- 通过 nginx、Caddy、Traefik 等反向代理运行，或使用自定义域名时，必须设置 VK_ALLOWED_ORIGINS；否则浏览器的 Origin 头与后端期望的 host 不匹配，API 请求会返回 403 Forbidden。
- 设为前端可访问的完整 origin：
单来源
VK_ALLOWED_ORIGINS=https://vk.example.com多来源（逗号分隔）
VK_ALLOWED_ORIGINS=https://vk.example.com,https://vk-staging.example.com- 自托管 Vibe Kanban Cloud 实例请参考官方 self-hosting guide。
七、远程部署（如 systemctl、Docker、云托管）
- 通过隧道访问：用 Cloudflare Tunnel、ngrok 或类似工具暴露 Web UI。
- 在 Settings → Editor Integration 配置远程 SSH：Remote SSH Host 填服务器主机名或 IP；Remote SSH User 填 SSH 用户名（可选）。
- 前置条件：本地能 SSH 访问远程服务器；已配置 SSH 密钥（免密认证）；安装 VSCode Remote-SSH 扩展。
- 配置完成后，“Open in VSCode” 按钮会生成形如 vscode://vscode-remote/ssh-remote+user@host/path 的 URL，在本地编辑器打开并连接远程服务器。
八、常见问题与协作约定
- 反向代理场景出现 403 Forbidden：检查是否设置并正确填写 VK_ALLOWED_ORIGINS。
- Windows 上 HOST=0.0.0.0 时 MCP 连接异常：把 MCP_HOST 设为 127.0.0.1。
- 调试时希望保留 worktree：设置 DISABLE_WORKTREE_CLEANUP。
- 请求新功能请开 GitHub Discussions；Bug 请在本仓库开 issue。
- 贡献流程：官方明确要求先通过 GitHub Discussions 或 Discord 与核心团队讨论想法与改动，未事先讨论不要直接提交 PR。
- 项目状态：页面公告 “Vibe Kanban is sunsetting.”，长期使用前请确认维护与自托管方案。
