Vibe Kanban项目详解
Vibe Kanban是一个专门为 AI编程助手(AI coding agents) 设计的开源可视化项目管理工具,它旨在解决"AI越来越多地编写代码,人类工程师将主要时间花在规划、审查和协调任务"这一新兴现状。该项目由BloopAI团队开发,项目地址为https://github.com/BloopAI/vibe-kanban。
一、 核心定位与目标
项目旨在成为一个"指挥中心",帮助开发者在利用Claude Code、Gemini CLI、Codex、Amp等多种AI助手编写代码时,实现高效的人工协同与管理。
二、 主要功能
Vibe Kanban提供了以下核心功能来优化AI辅助编程的流程:
- 多助手灵活切换:轻松在不同的AI编码助手(如从Claude切换到Gemini)之间切换,以适应不同任务需求。
- 并行与串行编排 :能够编排多个AI助手的任务流程,支持并行执行 以提升效率,或按指定顺序执行复杂任务链。
- 工作评审与开发服务器快速启动:方便开发者快速审查AI生成的代码,并可以一键启动开发服务器进行测试验证。
- 任务状态追踪:通过类似看板(Kanban)的界面,清晰追踪每个AI任务(如"待处理"、"进行中"、"已完成")的实时状态。
- 集中配置管理:统一管理和配置不同AI助手的MCP(Model Context Protocol)配置,简化环境设置。
- 远程项目管理 :当Vibe Kanban部署在远程服务器(如云端)时,它支持通过SSH远程打开项目,实现本地编辑器与远程开发环境的无缝集成。
三、 快速入门指南
-
安装
- 前提:确保你已经完成了你所选AI助手的身份验证。
- 通过一行命令即可安装:
npx vibe-kanban
-
获取帮助
- 详细文档和用户指南请访问项目官方网站。
四、 项目技术支持与参与
- 功能请求与反馈:使用GitHub Discussions功能。
- 报告Bug:在项目的GitHub仓库中提交Issue。
- 贡献代码 :鼓励开发者先在GitHub Discussions或Discord上与核心团队讨论提案和实现细节,**不建议在未提前沟通的情况下直接提交Pull Request (PR)**。
**五、 开发环境搭建(适用于想贡献代码的开发者)**
-
运行开发环境:
bashCopy Code
pnpm run dev这将启动后端服务,并从一个种子文件夹复制一个空数据库。
-
构建与测试:
- 仅构建前端:进入
frontend目录并运行pnpm build。 - 源码构建(macOS):运行
./local-build.sh。 - 本地测试CLI工具:进入
npx-cli目录,运行node bin/cli.js。
- 仅构建前端:进入
六、 配置与环境变量
项目支持通过环境变量进行灵活配置:
构建时 可配置POSTHOG_API_KEY(用于启用或禁用PostHog分析)。
运行时 可配置服务器端口(PORT)、前端开发端口(FRONTEND_PORT)、后端端口(BACKEND_PORT)及主机地址(HOST)等。
总结
Vibe Kanban是一个切中AI编程时代协作痛点的创新工具。它并非一个AI助手本身,而是一个**管理和编排多个AI助手的"元工具"**,通过可视化的看板界面和强大的流程控制能力,帮助开发者从繁琐的任务协调中解放出来,真正实现人机协作效率的倍增,充分利用不同的AI编程助手来完成复杂的软件开发工作。
实践
安装和启动
npx vibe-kanban
启动后显示:
E:\work\vibekanban>npx vibe-kanban
Need to install the following packages:
vibe-kanban@0.0.134
Ok to proceed? (y) y
📦 Extracting vibe-kanban...
🚀 Launching vibe-kanban...
2026-01-01T14:24:14.246797Z INFO services::services::config: No config file found, creating one
2026-01-01T14:24:14.249450Z INFO executors::profile: No user profiles.json found, using defaults only
2026-01-01T14:24:15.787960Z INFO local_deployment: Starting orphaned image cleanup...
2026-01-01T14:24:15.788147Z INFO services::services::oauth_credentials: OAuth credentials backend: file
2026-01-01T14:24:15.793013Z INFO local_deployment: Remote client initialized with URL: https://api.vibekanban.com
2026-01-01T14:24:15.795449Z INFO local_deployment::container: Starting periodic worktree cleanup...
2026-01-01T14:24:15.798485Z INFO services::services::pr_monitor: Starting PR monitoring service with interval 60s
2026-01-01T14:24:15.798832Z INFO services::services::file_search_cache: Starting file search cache warming...
2026-01-01T14:24:15.801868Z INFO services::services::file_search_cache: No active projects found, skipping cache warming
2026-01-01T14:24:15.803266Z INFO server: No PORT environment variable set, using port 0 for auto-assignment
2026-01-01T14:24:15.810486Z INFO server: Server running on http://127.0.0.1:64257
2026-01-01T14:24:15.810770Z INFO server: Opening browser...
登录和配置
浏览器打开:http://127.0.0.1:64257/

创建一个项目:
testvibe

再创建一个任务

很可惜啊,我的好像没有关联上。哦,明白了,这条机器没有opencode。
关联qwencode
安装好qwencode,然后关联上

哈哈,这个果然关联上了,任务开始跑了:

真不错!
其实从这个软件的ai agent选择,可以看到当前最流行的几款软件是:

总结
不错,Vibe Kanban确实是大家当前比较有用的工具之一。
但是关联AI agent里面没有国产的另几款软件有些遗憾,当然也可能是因为另几款软件比如Trae、Baidu Comate、Codebuddy不是终端软件,但是iFlow应该可以的啊。
调试
看log信息发现有报错
2026-01-01T14:39:34.652321Z INFO server::routes::tasks: Started attempt for task 80b19083-15c7-4e5a-84e0-53f6fbe18afa
2026-01-01T14:39:50.248519Z ERROR executors::executors::acp::harness: Failed to create session: Authentication required
2026-01-01T14:39:50.493888Z INFO local_deployment::container: Skipping cleanup script for task attempt 406a53bf-ddc8-4c4a-9be3-1d607dfc066e - no changes made by coding agent
Exception calling "Show" with "1" argument(s): "SQLITE_CONSTRAINT_UNIQUE (Exception from HRESULT: 0x87AF0813)"
At C:\Users\Admin\AppData\Local\bloop\utils\cache\toast-notification.ps1:23 char:1
-
Notifier.Show(Toast)
-
~~~~~~~~~~~~~~~~~~~~~~
-
CategoryInfo : NotSpecified: (:) [], MethodInvocationException
-
FullyQualifiedErrorId : Exception
看来是认证没有通过,我这台机器没有装opencode吗?
那就先装一个qwencode吧