BloopAI/vibe-kanban · 上手攻略
- 仓库：BloopAI/vibe-kanban
- 链接：https://github.com/BloopAI/vibe-kanban
- 分类：ai / coding agent tool
- 作者：Tom
- 更新：2026-07-11
这是什么
Vibe Kanban 是一个专为编程 Agent（Claude Code、Codex、Cursor 等）设计的看板式工作流管理工具，用 Rust + TypeScript 编写。它的核心理念是：在 AI 编程时代，工程师最大的时间消耗不是写代码，而是规划任务和 review AI 输出——所以最值得优化的环节是把规划和 review 做到极致。
本质上，它是一个本地优先的多 Agent 协作工作台： - 工程师用看板规划任务 - 给 Agent 分配专属 Git branch + terminal + dev server 的 Workspace - 在 UI 中 review diff、留评论、发 PR - 所有主流 coding agent 都能接入
解决什么问题
用纯 AI coding agent（如 Claude Code）的痛点： - 缺少结构：Agent 在一个巨大的 branch 上裸跑，任务边界不清晰 - review 困难：所有变更堆在一起，没有渐进式 review - 多 Agent 无法协同：无法同时让 Codex 和 Claude Code 在不同 branch 上并行跑 - Dev Server 不可控：Agent 的 dev server 在哪个端口、有没有正常启动，工程师很难掌控
Vibe Kanban 的解法： - 看板任务 → Agent Workspace 一一对应，每张卡给 Agent 一个隔离环境 - 内置 dev server + 浏览器 DevTools：inspect mode、device emulation 全支持 - 10+ Agent 支持：Claude Code、Codex、Gemini CLI、Copilot、Amp、Cursor 等 - PR 自动化：AI 生成 PR 描述，GitHub review，本地 merge
快速安装
方式一：直接运行（推荐尝鲜）
npx vibe-kanban
⚠️：需要先完成目标 coding agent 的身份认证（见各 Agent 官方文档）。
方式二：从源码构建
前提依赖： - Rust（rustup.rs，latest stable） - Node.js ≥ 20 - pnpm ≥ 8
# 开发依赖
cargo install cargo-watch
cargo install sqlx-cli
# 安装项目依赖
pnpm i
# 启动开发服务器（backend + web app）
pnpm run dev
首次启动会自动从 dev_assets_seed/ 复制空数据库。
方式三：自托管 Docker（生产）
# 见官方部署文档：https://vibekanban.com/docs/self-hosting/deploy-docker
核心用法
1. 创建任务（Kanban Card）
在 Web UI 中创建 Issue，自动成为看板上一张卡，可以： - 分配给特定 Agent Workspace - 设置优先级（拖拽排序） - 私密或团队可见
2. 启动 Agent Workspace
当一张卡进入 "Ready" 状态，点击启动，Vibe Kanban 会： 1. 创建专属 Git branch 2. 分配 terminal 3. 启动 dev server 4. Agent 在隔离环境内工作
3. Review diff
Agent 完成任务后，在 UI 中： - 查看完整 diff - 逐行留 inline comments - 直接反馈给 Agent（无需离开 UI）
4. 浏览器预览
内置浏览器支持： - DevTools - Inspect Mode（选中页面元素） - Device Emulation（手机/平板视图）
5. 创建 Pull Request
点击 "Create PR"： - 自动生成 PR 描述（AI 撰写） - 打开 GitHub review - 在 UI 中 merge
支持的 Agent 完整列表
以下基于官方文档，实际支持情况以 vibekanban.com/docs/supported-coding-agents 为准： - Claude Code - OpenAI Codex - Google Gemini CLI - GitHub Copilot - Amp - Cursor - OpenCode - Droid - CCR - Qwen Code
核心环境变量
| 变量 | 类型 | 默认 | 说明 |
|---|---|---|---|
PORT |
Runtime | 自动分配 | 生产服务器端口；dev 模式下是前端端口 |
BACKEND_PORT |
Runtime | 0（自动） | 后端端口（dev 模式，优先于 PORT+1） |
HOST |
Runtime | 127.0.0.1 | 后端 host |
DISABLE_WORKTREE_CLEANUP |
Runtime | 未设置 | 禁用 Git worktree 清理（调试用） |
VK_ALLOWED_ORIGINS |
Runtime | 未设置 | 反向代理场景下必填，多个逗号分隔 |
POSTHOG_API_KEY |
Build-time | 空 | PostHog 分析（空则禁用） |
反向代理注意 ⚠️
使用 nginx / Caddy / Traefik 时，必须设置：
VK_ALLOWED_ORIGINS=https://vk.example.com
# 多 origin：
VK_ALLOWED_ORIGINS=https://vk.example.com,https://vk-staging.example.com
否则浏览器 Origin 校验失败，返回 403。
远程服务器自托管
如果 Vibe Kanban 部署在远程服务器（如 via systemctl / Docker）：
- 用 Cloudflare Tunnel / ngrok 暴露 Web UI
- 在 Settings → Editor Integration 配置远程 SSH： - Remote SSH Host：服务器 IP/域名 - Remote SSH User：SSH 用户名（可选）
- 本地 VSCode 打开远程项目：
vscode://vscode-remote/ssh-remote+user@host/path
典型适用场景
- 团队 AI 编程流程标准化：用看板管理 AI 任务，渐进式 review，避免 Agent 产出失控
- 多 Agent 并行开发：不同 Agent 在不同 branch 同时跑，减少等待
- Code Review 体验优化：内置 diff view + inline comments，比 GitHub 原始界面更适合 review AI 产出
- 设计/前端团队：内置设备模拟器，适合验收 AI 生成的前端页面
- 自托管：Docker 一键部署，数据完全本地，适合重视数据隐私的团队
坑与注意
-
最近更新偏旧：卡片显示"最近提交 2026-04-24"，比其他两个仓库（2026-07-10）落后约 3 个月，生产使用前需确认项目活跃度。
-
pnpm 强依赖：项目必须用 pnpm（≥8），npm 或 yarn 不可替代。
-
Node.js 版本要求：≥ 20，老项目升级 Node 可能影响其他本地工具。
-
PostHog 分析：默认开启 build-time PostHog API key，如不需要分析功能，构建时传空值即可。
-
Git Worktree 清理：Vibe Kanban 会自动管理 Git worktree（创建/清理 Workspace），
DISABLE_WORKTREE_CLEANUP只在调试时开启，不要在正常生产环境使用。 -
多 Agent 协作场景有限：虽然支持 10+ Agent，但不同 Agent 之间无法直接通信，仍是"一个 Agent → 一个 Workspace"的单 Agent 模式，多 Agent 协作需要工程师手动协调。
-
安全考虑：Vibe Kanban 在本地起的 backend 有 SSH/RDP 连接远程服务器的能力，VK_ALLOWED_ORIGINS 配置不当可能导致 API 被滥用。
-
Windows 支持：HOST 环境变量设为
0.0.0.0时 Windows 下 MCP 连接会有问题，需要显式设置 MCP_HOST=127.0.0.1。
与同类对比
| 维度 | Vibe Kanban | Roo Code | GitHub Copilot Chat | Cursor |
|---|---|---|---|---|
| 定位 | 多 Agent 看板工作台 | 单 Agent VSCode 扩展 | IDE 内嵌对话 | AI 代码编辑器 |
| 多 Agent 协作 | ✅ 10+ Agent | ❌ | ❌ | ❌ |
| 看板管理 | ✅ 内置 | ❌ | ❌ | ❌ |
| PR 创建/Review | ✅ 内置 | 部分 | 部分 | 部分 |
| 内置 DevTools 预览 | ✅ | ❌ | ❌ | ❌ |
| 语言 | Rust + TS | TypeScript | — | TypeScript |
| 自托管 | ✅ Docker | ❌ | ❌ | ❌ |
| Stars | 27323 | ~14000 | — | 私有 |
最大差异：Vibe Kanban 是唯一一个把看板任务管理 + Agent Workspace + Code Review 三者融合的工具，尤其适合想把 AI coding agent 纳入团队开发流程的工程团队。
一句话结论
如果你在团队中使用 Claude Code / Codex 等编程 Agent、想要结构化任务管理和渐进式 review，Vibe Kanban 是目前体验最完整的开源方案；如果只是个人单兵作战、追求极简 AI 编程，直接用 Claude Code CLI 可能更轻便。
来源
- GitHub README：https://github.com/BloopAI/vibe-kanban
- 官网：https://vibekanban.com
- 官方文档：https://vibekanban.com/docs
- 自托管部署指南：https://vibekanban.com/docs/self-hosting/deploy-docker
- DeepWiki 解析：https://deepwiki.com/BloopAI/vibe-kanban