阿超 > vibe-kanban

vibe-kanban

2026-01-12

ai

荒废时间等于荒废生命。——川端康成

Vibe Kanban：把 AI Coding Agent 变成你真正的“协作开发队友”

“Get 10X more out of Claude Code, Codex 或任何 coding agent。”
这是 BloopAI/vibe-kanban 的一句话描述，也是这个项目的核心野心：让开发者在真实的工程节奏里，像��理工程团队一样，管理和编排多个 AI 编码代理，提升生产力、加速交付。

如果你已经在用 Claude Code、Gemini CLI、Amp 这类 coding agent，你大概很熟悉它们的“单点能力”：写函数、修 bug、生成测试、起个 dev server……但当工作进入“多任务、多代理、串并行协作、版本管理、代码评审、快速迭代”的真实场景时，光靠一个命令行工具就会显得捉襟见肘。

Vibe Kanban 做的，就是把这些代理“装进流程”，把你的开发节奏“装进一个看板”，并把所有和代码交互相关的动作（Git 仓库、分支、变更、工作树、开发脚本、编辑器启动、远程连接等）变成一套顺手的工具链。

它到底是什么？

官方的定义很直接：一个面向开发者的可视化项目管理工具，整合 Git 仓库与 AI coding agents，帮助你以看板方式管理任务、以流水线方式执行和审阅结果。

你能在它的界面里做这些事（节选自仓库的 npx-cli/README.md 和主 README.md）：

  • 项目（Git 仓库）管理：添加现有仓库或新建仓库、自动验证、全仓检索、按项目配置启动/开发脚本。
  • 任务（看板）管理：创建任务、维护 Todo/In Progress/Done 状态、丰富描述和备注、任务历史与尝试记录。
  • 多代理编排：在任务维度上触发多个 agent 的执行，串行或并行，跟踪状态与结果。
  • 开发工作流：为每次任务尝试创建隔离的 Git worktree，查看 agent 改动的 diff，合并成功变更回主分支、rebase 保持更新，必要时手动编辑或删除文件。
  • 开发者工具：从本地文件系统浏览仓库、在你偏爱的 IDE 中打开工作树（VS Code、Cursor、Windsurf、IntelliJ、Zed 等）、启动/管理 dev server、实时监控进程、单个或全部停止、任务完成提示音。
  • 配置集成：集中管理 MCP（Model Context Protocol）配置；当你在远程服务器运行 Vibe Kanban 时，通过 SSH 打开项目。
  • 远程 API（remote crate）：提供一个可部署的 Hosted API，支持 OAuth（GitHub/Google），用于更复杂的远程协作场景。

一句话：它既是一个“任务看板”，又是一个“多代理编排器”，还是一个“面向开发者的 Git 工作流驾驶舱”。

快速上手：真的一条命令

先确认你已经跟自己常用的 coding agent 完成了认证（支持的 agent 列表见官网文档）。然后在终端里直接：

1
npx vibe-kanban

它会在本地启动应用并自动打开浏览器。零安装、秒启动，先把东西跑起来再说。

如果你更偏向“边开边调”，搞个完整栈也很简单（下面是仓库里的远程服务 crates/remote/README.md 的原始配置）：

1
2
3
4
5
6
7
# .env.remote（自行放到仓库根目录）
VIBEKANBAN_REMOTE_JWT_SECRET=your_base64_encoded_secret
SERVER_PUBLIC_BASE_URL=http://localhost:3000
GITHUB_OAUTH_CLIENT_ID=your_github_web_app_client_id
GITHUB_OAUTH_CLIENT_SECRET=your_github_web_app_client_secret
GOOGLE_OAUTH_CLIENT_ID=your_google_web_app_client_id
GOOGLE_OAUTH_CLIENT_SECRET=your_google_web_app_client_secret

生成 JWT Secret（一次性即可）：

1
openssl rand -base64 48

本地起完整栈（含 Postgres 与 Hosted API）：

1
2
3
docker compose --env-file .env.remote -f docker-compose.yml up --build
# API 默认暴露在 http://localhost:8081
# Postgres: postgres://remote:remote@localhost:5432/remote

让前端指向这个 API，然后开发模式跑起来：

1
2
export VK_SHARED_API_BASE=http://localhost:8081
pnpm run dev

使用体验：把复杂的工程节奏拆成“很顺手”的动作

当你把一个仓库加进 Vibe Kanban，它立刻变成一个“有上下文的项目”：

  1. 在看板上创建一个任务（比如“把支付模块的日志整一整”、“为新接口补测试并起个 dev server 试试”）。
  2. 选择你要用的 agent（比如 Claude、Amp、或一个轻量的 Echo 做快速验证）。
  3. Vibe Kanban 会为这次尝试创建一个隔离的 Git worktree（非常关键：安全且干净），跑起你配置的脚本或 dev server。
  4. 实时看执行日志、随时停掉进程，一次执行不满意就再来一次。
  5. 执行完毕后查看 diff，审阅改动，满意就合并回主分支；如果主分支有了新进展，rebase 一下保持同步。
  6. 需要对文件做手动修订？直接在工作树里打开你惯用的 IDE。

这些动作在 CLI 里当然也能做，但当你在一天里要处理很多个任务、很多个代理、很多次尝试、很多个工作树，Vibe Kanban 把它们“收拾”到一个看板和一套统一的操作面板里，开发节奏会干净很多。

为什么它值得一试？

  • 真实工程场景的编排能力：并行与串行的 agent 协作，不是“单次调用”的玩具。
  • 面向 Git 的设计哲学：隔离 worktree、可审阅的 diff、可控的 merge/rebase，能对结果负责。
  • 工具链友好：IDE 打开、脚本启动、进程管理、dev server 支持，减少在不同工具之间来回切换的成本。
  • 扩展到远程：当你把它跑在服务器上，还是能“像本地一样”打开项目与任务，不牺牲开发体验。
  • 文档与社区：官网文档 vibekanban.com/docs 持续更新，功能需求走 GitHub Discussions，问题走 Issue；团队也在积极招募（主 README 有招聘链接）。

代码片段：从命令到工作流

以下代码案例都直接来自仓库文档（不做任何杜撰），用于快速复刻你的环境。

  • 一键启动本地应用：
1
npx vibe-kanban
  • 配置并启动 Hosted API（支持 GitHub/Google OAuth）：
1
2
3
4
5
6
7
# .env.remote
VIBEKANBAN_REMOTE_JWT_SECRET=your_base64_encoded_secret
SERVER_PUBLIC_BASE_URL=http://localhost:3000
GITHUB_OAUTH_CLIENT_ID=your_github_web_app_client_id
GITHUB_OAUTH_CLIENT_SECRET=your_github_web_app_client_secret
GOOGLE_OAUTH_CLIENT_ID=your_google_web_app_client_id
GOOGLE_OAUTH_CLIENT_SECRET=your_google_web_app_client_secret
1
2
3
4
5
6
# 本地起完整栈
docker compose --env-file .env.remote -f docker-compose.yml up --build

# 前端指向 API 并开发模式运行
export VK_SHARED_API_BASE=http://localhost:8081
pnpm run dev
  • 开发者前置条件（主 README）：
1
Rust（稳定版）

与 AI Coding Agents 的关系

Vibe Kanban 并不替代你的 coding agent，它做的是“编排与承载”：

  • 你仍然用 Claude Code、Gemini CLI、Amp（以及其他兼容的 agent）去“写代码与跑任务”。
  • Vibe Kanban 帮你把这些任务装进看板，把它们的执行放进一条“有 Git 背书”的工作流。
  • 结果可以被审阅、被 diff、被合并、被回滚、被记录；失败的尝试也可以“在历史里”被理解，而不是丢进滚动的终端输出。

这就是“Get 10X more out of coding agents”的现实含义：不是把 agent 变更为更强，而是让它们能更好地在你的工程流程里发挥。

小贴士与参考

总结

如果你正在把 AI Coding Agents 带入日常开发工作，那么 Vibe Kanban 是一个“把零散能力装进工程流程”的利器。它不是另一个 IDE 插件，也不是一个新的 Agent，而是一个轻量却务实的“开发流程驾驶舱”：从项目到任务，从执行到评审，从本地到远程，用你熟悉的工具与习惯，不打断你的节奏，反而让节奏更顺畅。

写代码的速度取决于 Agent，交付的速度取决于工程流程。Vibe Kanban 专注的是后者。

附注：本文内容严格基于仓库的 README 与子模块文档（如 npx-cli/README.md、crates/remote/README.md），未做任何功能杜撰。更多细节请直接查阅仓库与官网文档。