Vibe Kanban：为 AI 编程工具装上「指挥官大脑」

⚠️ 重要提示：Vibe Kanban 已于近期宣布关闭服务（Sunsetting），详情见 官方公告。本文档基于代码库分析，记录该项目关闭前的技术实现与产品形态。

背景：AI 编程工具时代的「指挥失灵」困境

当你同时使用 Claude Code、GitHub Copilot、Amp 等多个 AI 编程工具时，是否曾面临这样的局面——一个工具在改 A 模块，另一个在改 B 模块，彼此互不知情；AI 一口气生成了 50 个文件，你还没来得及 review 就被合并了；任务边界模糊，AI 自说自话地把你的项目改得面目全非。

这背后是一个结构性问题：AI 编程工具擅长执行，但缺乏全局协调能力。

BloopAI 团队注意到了这个痛点。2024 年，他们推出了 Vibe Kanban——一个专门为 AI 编程工具打造的「指挥官仪表盘」，让人类开发者重新掌握规划、审查和协调的主动权。

核心功能：一套工具，多重角色

Vibe Kanban 的本质是一个任务规划 + 执行编排 + 代码审查的一体化平台，同时支持 10+ 种主流 AI 编程工具，包括 Claude Code、Codex、Gemini CLI、GitHub Copilot、Amp、Cursor、OpenCode、Droid、CCR、Qwen Code 等。

图1：Vibe Kanban 主界面，集成看板与工作区管理

看板式任务规划

传统 AI 编程中，任务描述往往以长文本形式塞给 AI，边界模糊、责任不清。Vibe Kanban 引入了看板式任务管理，将工作拆解为独立的 Issue，每个 Issue 可分配优先级、标签、子任务，并关联到具体的工作区（Workspace）。

图2：Kanban 看板，支持创建优先级标签和子任务体系

Workspace：AI 的「专属工位」

每个 Workspace 是 AI 的独立工作空间，包含：一个 Git 分支、一个终端会话、一个预览开发服务器。当多个 AI 同时工作时，每个 AI 操作自己独立的分支，彻底避免了代码覆盖和冲突混乱。

开发者可以随时在 Workspace 中：

• 发送消息给 AI，指导方向、补充上下文
• 查看日志，实时监控 AI 的思考过程和工具调用
• 打开预览浏览器，检查 UI 改动是否正确
• 创建 PR 并发起 Code Review，直接在 UI 中留下行内评论

图3：Workspace 界面，支持多 Repo 管理、日志监控和内置预览

内置预览与调试

除了传统浏览器预览，Vibe Kanban 还提供了Inspect Mode（组件层级检查）、Device Emulation（设备模拟），以及 DevTools 面板。开发者不需要切换到真实浏览器，即可在平台内完成完整的 UI 验证。

多 Agent 协作与 MCP 支持

项目支持 **MCP（Model Context Protocol）**协议，允许接入各类 MCP Server（如 Raycast 等流行工具的 MCP 集成），扩展 AI 的工具调用能力。平台内置了 Git 操作、文件管理、终端命令等核心执行器。

技术架构：Rust 底层 + TypeScript 前端的硬核组合

后端：全 Rust 实现

核心后端完全使用 Rust 编写，包含 35+ 个 workspace crate，按职责划分为：

• crates/server：REST API 服务器，处理前端请求
• crates/db：基于 SQLx 的数据库层，包含完整的数据库迁移脚本
• crates/executors：各 AI Agent 的执行器适配层（Claude Code、Codex、Gemini CLI 等）
• crates/git：Git 操作封装（branch、worktree、commit、PR 等）
• crates/review：代码审查工具，支持行内评论
• crates/worktree-manager：Git worktree 管理，多 Workspace 并行
• crates/deployment & crates/local-deployment：本地/远程部署逻辑
• crates/remote：远程访问模式
• crates/mcp：MCP 协议服务端实现
• crates/relay-*：WebSocket / WebRTC 中继层，用于远程连接

这种 Rust-first 的架构带来了显著优势：内存占用低、启动速度快、并发处理能力强。实测本地启动后端服务仅需几百 MB 内存，即使运行多个 Workspace 也不会卡顿。

前端：React + TypeScript + Vite + Tailwind

前端采用标准的现代 Web 技术栈：

• packages/local-web：本地应用入口，基于 Vite + React + Tailwind CSS
• packages/remote-web：远程部署时的前端入口
• packages/ui：共享 UI 组件库
• packages/web-core：Web 核心逻辑

前端通过 HTTP/WebSocket 与 Rust 后端通信，Web UI 体验流畅，支持暗色模式。

数据库：SQLite + SQLx

开发阶段使用 SQLite，生产环境同样可切换至 PostgreSQL。数据库迁移由 SQLx CLI 统一管理，所有模型定义和迁移脚本都在 crates/db 中。

部署方式：Docker 一键或 npx 极速启动

Vibe Kanban 提供了多层次的部署选项，覆盖从「零配置体验」到「生产级自托管」的全场景：

方式	难度	适用场景
npx vibe-kanban	⭐ 极简	零配置本地体验，最快上手
pnpm run dev（源码）	⭐⭐ 简单	本地开发调试
Docker 镜像构建	⭐⭐⭐ 中等	生产环境自托管
远程服务器部署	⭐⭐⭐⭐ 复杂	团队协作、远程访问

Docker 部署：项目提供完整的多阶段 Dockerfile，构建产物为 Node.js 前端 + Rust 后端的组合镜像。默认开启 PostHog 分析（可配置为空以禁用隐私追踪）。

硬件需求：无 GPU 要求，CPU 架构需支持 x86-64 或 ARM64，推荐 4GB+ RAM、2GB+ 磁盘空间。

环境变量配置：支持 PORT、HOST、VK_ALLOWED_ORIGINS（反向代理场景必须配置）、MCP_HOST/MCP_PORT（MCP 服务连接）等。

⚠️ 关键风险：项目正在关闭

这是选择 Vibe Kanban 前必须了解的现实：

该项目已于近期宣布 Sunsetting（逐步关闭），官方公告地址：https://www.vibekanban.com/blog/shutdown。这意味着：

1. 不再有新功能开发，当前代码库进入维护状态
2. 云服务将停止运营，远程协作功能无法使用
3. 社区支持有限，Issues 和 Discussions 响应可能不及时
4. 长期风险未知，未来可能完全归档

但项目代码仍为开源，具备以下价值：

• 学习 Rust 后端 + React 前端的全栈架构设计
• 参考多 Agent 执行器的适配层实现（MCP、Claude Code、Codex 等）
• 借鉴 Git worktree 在 CI/CD 场景中的应用
• 作为内部工具的基础框架进行二次开发

行业意义：从「让 AI 干活」到「让 AI 按计划干活」

Vibe Kanban 代表了一种新兴的产品范式：不是让 AI 替代人类做规划，而是让人类用更高效的方式给 AI 下达指令。它的看板设计借鉴了成熟的敏捷方法论，将其适配到人机协作场景。

从技术角度看，项目在以下方面具有参考价值：

• Rust 异步运行时（Tokio）处理多客户端并发
• Git worktree 在沙箱化执行环境中的应用
• WebSocket 中继实现远程访问的技术路径
• MCP 协议的服务端实现样本

虽然项目本身即将关闭，但它所开创的「AI 编程指挥官」品类，证明了一个核心判断：AI 编程工具的下一个竞争维度，不是模型能力，而是人机协作的体验设计。