Get 10X more out of Claude Code, Gemini CLI, Codex, Amp and other coding agents...

我们正在招聘！

 ## 概述 在软件工程师将大部分时间用于规划和审查 coding agents 的世界中，提高交付效率最有效的方式是加快规划和审查的速度。 Vibe Kanban 正是为解决此问题而生。使用看板问题（kanban issues）来规划工作，无论是私下进行还是与团队协作。准备好开始时，创建工作区（workspaces），让 coding agents 在其中执行任务。 - **使用看板问题进行规划** — 在看板上创建、排序和分配问题 - **在工作区中运行 coding agents** — 每个工作区为 agent 提供一个分支、一个终端和一个开发服务器 - **审查 diff 并留下行内评论** — 无需离开 UI 即可直接向 agent 发送反馈 - **预览你的应用** — 内置浏览器，包含 devtools、inspect mode 和设备模拟功能 - **在 10+ 个 coding agents 之间切换** — Claude Code, Codex, Gemini CLI, GitHub Copilot, Amp, Cursor, OpenCode, Droid, CCR 和 Qwen Code - **创建 pull requests 并合并** — 打开带有 AI 生成描述的 PR，在 GitHub 上审查并合并  一个命令。描述工作，审查 diff，发布它。 ``` npx vibe-kanban ``` ## 安装说明 确保你已经通过自己偏好的 coding agent 进行了身份验证。支持的 coding agents 完整列表可以在[文档](https://vibekanban.com/docs/supported-coding-agents)中找到。然后在终端中运行： ``` npx vibe-kanban ``` ## 文档 前往[网站](https://vibekanban.com/docs)获取最新的文档和用户指南。 ## 自托管 想要托管你自己的 Vibe Kanban Cloud 实例？请参阅我们的[自托管指南](https://vibekanban.com/docs/self-hosting/deploy-docker)。 ## 支持 我们使用 [GitHub Discussions](https://github.com/BloopAI/vibe-kanban/discussions) 来收集功能请求。请开启一个讨论来创建功能请求。对于 bug，请在此仓库中开启一个 issue。 ## 贡献指南 我们希望想法和更改首先通过 [GitHub Discussions](https://github.com/BloopAI/vibe-kanban/discussions) 或 [Discord](https://discord.gg/AC4nwVtJM3) 与核心团队沟通，在那里我们可以讨论实现细节以及与现有路线图的一致性。请勿在未与团队讨论你的提案之前直接开启 PR。 ## 开发指南 ### 前置条件 - [Rust](https://rustup.rs/) (最新稳定版) - [Node.js](https://nodejs.org/) (>=20) - [pnpm](https://pnpm.io/) (>=8) 额外的开发工具： ``` cargo install cargo-watch cargo install sqlx-cli ``` 安装依赖： ``` pnpm i ``` ### 运行开发服务器 ``` pnpm run dev ``` 这将启动后端和 Web 应用。一个空白的数据库将从 `dev_assets_seed` 文件夹中复制。 ### 构建 Web 应用 仅构建 Web 应用： ``` cd packages/local-web pnpm run build ``` ### 从源码构建 1. 运行 `./local-build.sh` 2. 使用 `cd npx-cli && node bin/cli.js` 进行测试 ### 环境变量 以下环境变量可以在构建时或运行时配置： | 变量 | 类型 | 默认值 | 描述 | |----------|------|---------|-------------| | `POSTHOG_API_KEY` | Build-time | Empty | PostHog 分析 API 密钥（如果为空则禁用分析） | | `POSTHOG_API_ENDPOINT` | Build-time | Empty | PostHog 分析端点（如果为空则禁用分析） | | `PORT` | Runtime | Auto-assign | **生产环境**：服务器端口。**开发环境**：前端端口（后端使用 PORT+1） | | `BACKEND_PORT` | Runtime | `0` (auto-assign) | 后端服务器端口（仅限开发模式，覆盖 PORT+1） | | `FRONTEND_PORT` | Runtime | `3000` | 前端开发服务器端口（仅限开发模式，覆盖 PORT） | | `HOST` | Runtime | `127.0.0.1` | 后端服务器主机 | | `MCP_HOST` | Runtime | Value of `HOST` | MCP 服务器连接主机（在 Windows 上当 `HOST=0.0.0.0` 时使用 `127.0.0.1`） | | `MCP_PORT` | Runtime | Value of `BACKEND_PORT` | MCP 服务器连接端口 | | `DISABLE_WORKTREE_CLEANUP` | Runtime | Not set | 禁用所有 git worktree 清理，包括孤立和过期工作区的清理（用于调试） | | `VK_ALLOWED_ORIGINS` | Runtime | Not set | 允许向后端发起 API 请求的来源列表，以逗号分隔（例如 `https://my-vibekanban-frontend.com`） | | `VK_SHARED_API_BASE` | Runtime | Not set | 本地桌面应用使用的远程/云端 API 的 Base URL | | `VK_SHARED_RELAY_API_BASE` | Runtime | Not set | 隧道模式连接使用的 Relay API 的 Base URL | | `VK_TUNNEL` | Runtime | Not set | 设置时启用 Relay 隧道模式（需要 Relay API Base URL） | **Build-time 变量**必须在运行 `pnpm run build` 时设置。**Runtime 变量**在应用程序启动时读取。 #### 通过反向代理或自定义域名进行自托管 当在反向代理（例如 nginx, Caddy, Traefik）或自定义域名后运行 Vibe Kanban 时，你必须设置 `VK_ALLOWED_ORIGINS` 环境变量。否则，浏览器的 Origin 标头将与后端预期的主机不匹配，API 请求将被拒绝并返回 403 Forbidden 错误。 将其设置为你的前端可访问的完整来源 URL： ``` # Single origin VK_ALLOWED_ORIGINS=https://vk.example.com # Multiple origins (comma-separated) VK_ALLOWED_ORIGINS=https://vk.example.com,https://vk-staging.example.com ``` ### 远程部署 当在远程服务器（例如通过 systemctl, Docker 或云托管）上运行 Vibe Kanban 时，你可以将编辑器配置为通过 SSH 打开项目： 1. **通过隧道访问**：使用 Cloudflare Tunnel, ngrok 或类似工具暴露 Web UI 2. **在 Settings → Editor Integration 中配置远程 SSH**： - 将 **Remote SSH Host** 设置为你的服务器主机名或 IP - 将 **Remote SSH User** 设置为你的 SSH 用户名（可选） 3. **前置条件**： - 从本地机器到远程服务器的 SSH 访问权限 - 已配置 SSH 密钥（无密码认证） - VSCode Remote-SSH 扩展 配置完成后，“Open in VSCode” 按钮将生成类似 `vscode://vscode-remote/ssh-remote+user@host/path` 的 URL，这些 URL 将打开你的本地编辑器并连接到远程服务器。 有关详细的设置说明，请参阅[文档](https://vibekanban.com/docs/settings/general)。

标签：AI编程助手, Claude Code, Codex, Gemini CLI, Git分支管理, IP 地址批量处理, Linux 内核安全, MITM代理, 代码审查, 代码执行环境, 代码预览, 任务规划, 任务调度, 可视化界面, 团队协作, 威胁情报, 工作流自动化, 开发者工具, 效率提升, 浏览器开发工具, 看板管理, 通知系统, 项目管理