
Vibe Kanban:让 AI 编程效率提升 10 倍的看板工作台

在一个软件工程师花大部分时间规划和审查 coding agents 的世界里。
交付更多代码的最有影响力的方法是:
在规划和审查上变得更快。
Vibe Kanban 为此而生。
核心愿景

Vibe Kanban 的目标:
让 AI 编程效率提升 10 倍。
如何做?
通过看板管理 AI 编程的整个生命周期:规划 → 执行 → 审查 → 交付。
核心理念:
在一个软件工程师花大部分时间规划和审查 coding agents 的世界里,交付更多代码的最有影响力的方法是在规划和审查上变得更快。
一条命令启动
一个命令。
npx vibe-kanban描述工作,审查 diff,交付代码。
前提:
确保你已使用你最喜欢的 coding agent 进行身份验证。
支持的 coding agents:
- Claude Code
- Gemini CLI
- Codex
- GitHub Copilot
- Amp
- Cursor
- OpenCode
- Droid
- CCR
- Qwen Code
六大核心功能

1. 用看板 issues 规划工作
创建、确定优先级和分配看板板上的 issues。
可以是私人的,也可以与团队一起。
功能:
- 创建 issues
- 确定优先级
- 分配 issues
- 拖拽流转
- 团队协作
价值:
- 可视化工作流
- 优先级清晰
- 进度透明
2. 在 workspaces 中运行 coding agents
每个 workspace 给 agent:
- 一个分支
- 一个终端
- 一个 dev server
功能:
- 自动创建分支
- 自动启动终端
- 自动启动 dev server
- 隔离环境
- 并行执行
价值:
- 开箱即用
- 环境一致
- 并行工作
3. 审查 diffs 并留下行内评论
直接向 agent 发送反馈,无需离开 UI。
功能:
- 实时查看 diffs
- 行内评论
- 反馈到 agent
- 迭代改进
- 无缝集成
价值:
- 快速审查
- 精确反馈
- 高效迭代
4. 预览你的应用
内置浏览器:
- Devtools
- Inspect 模式
- 设备仿真
功能:
- 实时预览
- 设备模拟
- 调试工具
- 无需切换窗口
价值:
- 即时反馈
- 多设备测试
- 高效调试
5. 在 10+ coding agents 之间切换
支持 10+ coding agents:
- Claude Code
- Codex
- Gemini CLI
- GitHub Copilot
- Amp
- Cursor
- OpenCode
- Droid
- CCR
- Qwen Code
功能:
- 无缝切换
- 统一接口
- 灵活选择
价值:
- 工具自由
- 最佳匹配
- 无锁定
6. 创建 pull requests 并合并
打开带有 AI 生成描述的 PR。
功能:
- AI 生成 PR 描述
- 在 GitHub 上审查
- 合并
- 自动化流程
价值:
- 自动描述
- 一键审查
- 无缝交付
完整工作流

规划阶段
使用看板 issues 规划工作。
动作:
- 创建 issues
- 确定优先级
- 分配 issues
- 拖拽流转
输出:
- 清晰的工作列表
- 明确的优先级
- 分配的责任
执行阶段
在 workspaces 中运行 coding agents。
动作:
- 创建 workspace
- 自动创建分支
- 自动启动终端
- 自动启动 dev server
- Agent 开始工作
输出:
- 隔离的环境
- 运行的 agent
- 实时的进度
审查阶段
审查 diffs 并留下行内评论。
动作:
- 实时查看 diffs
- 行内评论
- 发送反馈到 agent
- Agent 迭代改进
输出:
- 精确的反馈
- 改进的代码
- 高质量的交付
交付阶段
创建 pull requests 并合并。
动作:
- AI 生成 PR 描述
- 在 GitHub 上审查
- 合并
- 清理 workspace
输出:
- 合并的代码
- 完整的记录
- 清理的环境
架构设计

Vibe Kanban 由三个主要组件组成:
1. 前端(Web App)
技术栈:
- React
- TypeScript
- Tailwind CSS
功能:
- 看板 board
- Workspace 管理
- Diff 审查
- 内置浏览器
- 设备仿真
2. 后端(Rust)
技术栈:
- Rust(最新稳定版)
- SQLx(数据库)
- MCP(Model Context Protocol)
功能:
- API 服务器
- 数据库管理
- Git worktree 管理
- Terminal 管理
- Coding agent 集成
3. CLI
技术栈:
- Node.js
- npm
功能:
- 一条命令启动
- 自动更新
- 配置管理
- 身份验证
环境变量配置

构建时变量
| 变量 | 类型 | 默认值 | 描述 |
|---|---|---|---|
| POSTHOG_API_KEY | Build-time | 空 | PostHog analytics API key(如果为空则禁用 analytics) |
| POSTHOG_API_ENDPOINT | Build-time | 空 | PostHog analytics endpoint(如果为空则禁用 analytics) |
运行时变量
| 变量 | 类型 | 默认值 | 描述 |
|---|---|---|---|
| PORT | Runtime | 自动分配 | 生产:服务器端口。Dev:前端端口(后端使用 PORT+1) |
| BACKEND_PORT | Runtime | 0(自动分配) | 后端服务器端口(仅 dev 模式,覆盖 PORT+1) |
| FRONTEND_PORT | Runtime | 3000 | 前端 dev server 端口(仅 dev 模式,覆盖 PORT) |
| HOST | Runtime | 127.0.0.1 | 后端服务器主机 |
| MCP_HOST | Runtime | HOST 的值 | MCP 服务器连接主机(Windows 上 HOST=0.0.0.0 时使用 127.0.0.1) |
| MCP_PORT | Runtime | BACKEND_PORT 的值 | MCP 服务器连接端口 |
| DISABLE_WORKTREE_CLEANUP | Runtime | 未设置 | 禁用所有 git worktree 清理,包括孤立和过期的 workspace 清理(用于调试) |
| VK_ALLOWED_ORIGINS | Runtime | 未设置 | 允许发出后端 API 请求的 origin 列表(逗号分隔) |
| VK_SHARED_API_BASE | Runtime | 未设置 | 本地桌面应用使用的远程/云 API 的基础 URL |
| VK_SHARED_RELAY_API_BASE | Runtime | 未设置 | tunnel-mode 连接使用的 relay API 的基础 URL |
| VK_TUNNEL | Runtime | 未设置 | 设置时启用 relay tunnel 模式(需要 relay API 基础 URL) |
反向代理配置
当 Vibe Kanban 运行在反向代理后面(例如 nginx、Caddy、Traefik)或自定义域上时:
必须设置 VK_ALLOWED_ORIGINS 环境变量。
没有这个:
- 浏览器的 Origin header 将不匹配后端的预期主机
- API 请求将被拒绝,403 Forbidden 错误
设置:
# 单个 origin
VK_ALLOWED_ORIGINS=https://vk.example.com
# 多个 origins(逗号分隔)
VK_ALLOWED_ORIGINS=https://vk.example.com,https://vk-staging.example.com远程服务器配置

当 Vibe Kanban 运行在远程服务器上时(例如通过 systemctl、Docker 或云托管):
你可以配置编辑器通过 SSH 打开项目。
访问方式
通过 tunnel 访问:
- 使用 Cloudflare Tunnel
- 使用 ngrok
- 或类似工具暴露 web UI
配置远程 SSH
在 Settings → Editor Integration 中:
设置:
- Remote SSH Host:你的服务器主机名或 IP
- Remote SSH User:你的 SSH 用户名(可选)
前提条件:
- 从本地机器到远程服务器的 SSH 访问
- SSH keys 配置(无密码认证)
- VSCode Remote-SSH 扩展
结果
" 配置后,"Open in VSCode" 按钮将生成如下 URL:
vscode://vscode-remote/ssh-remote+user@host/path这些 URL 将:
- 打开你的本地编辑器
- 连接到远程服务器
开发模式
前提条件
- Rust(最新稳定版)
- Node.js(>= 20)
- pnpm(>= 8)
额外开发工具:
cargo install cargo-watch
cargo install sqlx-cli安装依赖
pnpm i启动开发服务器
pnpm run dev这将启动后端和 web app。
空白 DB 将从 dev_assets_seed 文件夹复制。
仅构建 web app
cd packages/local-web
pnpm run build本地构建
# 运行构建脚本
./local-build.sh
# 测试
cd npx-cli && node bin/cli.js自托管

想要托管你自己的 Vibe Kanban Cloud 实例?
参见我们的自托管指南:
https://vibekanban.com/docs/self-hosting/deploy-docker
社区与贡献

功能请求
我们使用 GitHub Discussions 进行功能请求。
请打开一个 discussion 来创建功能请求。
对于 bug,请在这个 repo 上打开一个 issue。
贡献
我们更希望首先通过以下方式提出想法和更改:
我们可以讨论实现细节和与现有路线图的一致性。
请不要在未先与团队讨论你的提案的情况下打开 PR。
Vibe Kanban vs 其他工具
| 特性 | Vibe Kanban | 传统 IDE | 其他 AI 工具 |
|---|---|---|---|
| 看板管理 | ✅ 内置 | ❌ | ❌ |
| 多 Agent 支持 | ✅ 10+ | ❌ | 部分 |
| 实时 Diff 审查 | ✅ 行内评论 | ❌ | 部分 |
| 内置浏览器 | ✅ Devtools + 设备仿真 | ❌ | ❌ |
| Workspace 隔离 | ✅ 自动 | ❌ | ❌ |
| PR 自动化 | ✅ AI 生成描述 | ❌ | 部分 |
| 团队协作 | ✅ 看板共享 | 部分 | ❌ |
关键洞察

Vibe Kanban 不是另一个 AI 编码工具。
Vibe Kanban 是 AI 编码的工作台。
传统 AI 编码:
你手动管理环境、手动创建分支、手动启动 server、手动审查代码、手动创建 PR
Vibe Kanban:
看板管理 issues → 自动创建 workspace → 自动创建分支 → 自动启动 server → 实时审查 diffs → 行内反馈到 agent → 自动创建 PR → 一键合并
Vibe Kanban 的价值:
在一个软件工程师花大部分时间规划和审查 coding agents 的世界里
交付更多代码的最有影响力的方法是在规划和审查上变得更快
Vibe Kanban 让你:
- 用看板规划工作
- 在 workspaces 中运行 agents
- 实时审查 diffs
- 预览你的应用
- 在 10+ agents 之间切换
- 创建 PR 并合并
一个命令。
描述工作,审查 diff,交付代码。
让 AI 编程效率提升 10 倍。
Vibe Kanban
让 AI 编程效率提升 10 倍的看板工作台。
