从 Claude Code、GitHub Copilot、Amp 等编码代理中获得 10 倍以上的效率提升…
Vibe Kanban 即将停止运营。 查看公告。
概述
在软件工程师将大部分时间用于规划和审查编码代理的世界里，提高规划和审查效率是加快交付的最有效方式。
Vibe Kanban 正是为此而打造。使用看板问题来规划工作，可以是私密的或与团队一起。当准备开始时，创建工作空间，让编码代理可以执行任务。
- 用看板问题进行规划 — 在看板上创建、优先级排序和分配问题
- 在工作空间中运行编码代理 — 每个工作空间为代理提供分支、终端和开发服务器
- 审查代码差异并留下内联评论 — 无需离开界面即可直接向代理发送反馈
- 预览你的应用 — 内置浏览器，带开发工具、检查模式和设备模拟
- 在 10+ 编码代理之间切换 — Claude Code、Codex、GitHub Copilot、Amp、Cursor、OpenCode、Droid、CCR 和 Qwen Code
- 创建拉取请求并合并 — 使用 AI 生成的描述打开 PR，在 GitHub 上审查并合并
一条命令。描述工作内容，审查代码差异，交付。
安装
请确保已对你喜欢的编码代理完成身份验证。支持的编码代理完整列表可在文档中找到。然后在终端中运行：
文档
前往官网获取最新的文档和用户指南。
自托管
想要托管你自己的 Vibe Kanban Cloud 实例？参见我们的自托管指南。
支持
我们使用 GitHub Discussions 来处理功能请求。请发起讨论来创建功能请求。Bug 请在此仓库提交 issue。
贡献
我们希望首先通过 GitHub Discussions 或 Discord 与核心团队讨论想法和更改，这样可以讨论实现细节并与现有路线图保持一致。请勿在未先与团队讨论提案的情况下提交 PR。
开发
前置要求
其他开发工具：
安装依赖：
运行开发服务器
这将启动后端和 Web 应用。空白数据库将从 dev_assets_seed 文件夹复制。
构建 Web 应用
仅构建 Web 应用：
从源码构建（macOS）
- 运行
./local-build.sh - 使用
cd npx-cli && node bin/cli.js测试
环境变量
以下环境变量可在构建时或运行时配置：
| 变量 | 类型 | 默认值 | 说明 |
|---|---|---|---|
POSTHOG_API_KEY | 构建时 | 空 | PostHog 分析 API 密钥（为空则禁用分析功能） |
POSTHOG_API_ENDPOINT | 构建时 | 空 | PostHog 分析端点（为空则禁用分析功能） |
PORT | 运行时 | 自动分配 | 生产环境：服务器端口。开发环境：前端端口（后端使用 PORT+1） |
BACKEND_PORT | 运行时 | 0（自动分配） | 后端服务器端口（仅开发模式，覆盖 PORT+1） |
FRONTEND_PORT | 运行时 | 3000 | 前端开发服务器端口（仅开发模式，覆盖 PORT） |
HOST | 运行时 | 127.0.0.1 | 后端服务器主机 |
MCP_HOST | 运行时 | HOST | MCP 服务器连接主机（在 Windows 上使用 127.0.0.1 时使用 HOST=0.0.0.0） |
MCP_PORT | 运行时 | BACKEND_PORT | MCP 服务器连接端口 |
DISABLE_WORKTREE_CLEANUP | 运行时 | 未设置 | 禁用所有 git worktree 清理，包括孤立和工作区过期清理（用于调试） |
VK_ALLOWED_ORIGINS | 运行时 | 未设置 | 允许向后端 API 发起请求的来源 origins 列表，用逗号分隔（例如 https://my-vibekanban-frontend.com) |
VK_SHARED_API_BASE | 运行时 | 未设置 | 本地桌面应用使用的远程/云 API 基础 URL |
VK_SHARED_RELAY_API_BASE | 运行时 | 未设置 | 隧道模式连接使用的中继 API 基础 URL |
VK_TUNNEL | 运行时 | 未设置 | 设置后启用中继隧道模式（需要中继 API 基础 URL） |
构建时变量必须在执行 pnpm run build 时设置。运行时变量在应用程序启动时读取。
使用反向代理或自定义域名自托管
当在反向代理（如 nginx、Caddy、Traefik）后运行 Vibe Kanban，或使用自定义域名时，必须设置 VK_ALLOWED_ORIGINS 环境变量。否则浏览器的 Origin 请求头将与后端预期的主机不匹配，API 请求将被拒绝并返回 403 Forbidden 错误。
请将其设置为前端可访问的完整源站 URL：
远程部署
在远程服务器上运行 Vibe Kanban（如通过 systemctl、Docker 或云托管）时，您可以配置编辑器通过 SSH 打开项目：
- 通过隧道访问：使用 Cloudflare Tunnel、ngrok 或类似工具暴露 Web UI
- 在"设置 → 编辑器集成"中配置远程 SSH：
- 将远程 SSH 主机设置为您服务器的 hostname 或 IP
- 将远程 SSH 用户设置为您 SSH 用户名（可选）
- 前提条件：
- 从本地机器到远程服务器的 SSH 访问权限
- SSH 密钥已配置（无密码认证）
- VSCode Remote-SSH 扩展
配置完成后，"在 VSCode 中打开"按钮将生成类似 vscode://vscode-remote/ssh-remote+user@host/path 的 URL，在本地编辑器中打开并连接到远程服务器。
详见文档中的详细设置说明。
社区讨论
讨论与评分
先沉淀真实使用经验，评分作为可选信号补充。