让 Claude Code、Gemini CLI、Codex、Amp 等编码助手的效率提升 10 倍……

我们正在招聘！

概述

在软件工程师将大部分时间用于规划和评审编码助手的世界里，提高交付效率最有效的方式就是加快规划与评审的速度。

Vibe Kanban 就是为此而生。你可以使用看板任务来规划工作，无论是私下进行还是与团队协作。当你准备好开始时，可以创建工作空间，让编码助手在其中执行任务。

• 用看板任务规划 — 在看板上创建、优先级排序并分配任务
• 在工作空间中运行编码助手 — 每个工作空间都会为助手提供一个分支、一个终端和一个开发服务器
• 评审差异并留下内联评论 — 直接在 UI 内向助手发送反馈，无需切换界面
• 预览你的应用 — 内置浏览器，带有开发者工具、检查模式和设备模拟功能
• 在 10 多种编码助手中切换 — Claude Code、Codex、Gemini CLI、GitHub Copilot、Amp、Cursor、OpenCode、Droid、CCR 和 Qwen Code
• 创建并合并拉取请求 — 使用 AI 生成的描述打开 PR，在 GitHub 上评审并合并

只需一条命令：描述工作、评审差异、完成交付。

npx vibe-kanban

安装

请确保你已使用自己喜欢的编码助手完成身份验证。支持的编码助手完整列表可在文档中找到。然后在终端中运行：

npx vibe-kanban

文档

访问网站以获取最新的文档和用户指南。

自托管

想托管自己的 Vibe Kanban Cloud 实例吗？请参阅我们的自托管指南。

支持

我们使用 GitHub Discussions 来收集功能请求。请开一个讨论来提出新功能需求。如遇 bug，请在此仓库中提交 issue。

贡献

我们更希望您先通过 GitHub Discussions 或 Discord 与核心团队沟通您的想法和变更，以便我们讨论实现细节以及与现有路线图的契合度。请勿在未与团队讨论之前直接提交 PR。

开发

先决条件

• Rust（最新稳定版）
• Node.js（≥20）
• pnpm（≥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

从源代码构建（macOS）

1. 运行 ./local-build.sh
2. 使用 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 上 HOST=0.0.0.0 时，使用 127.0.0.1）
MCP_PORT	运行时	等于 BACKEND_PORT	MCP 服务器连接端口
DISABLE_WORKTREE_CLEANUP	运行时	未设置	禁用所有 Git 工作树清理，包括孤立和过期工作空间的清理（用于调试）
VK_ALLOWED_ORIGINS	运行时	未设置	允许发起后端 API 请求的来源地址列表，以逗号分隔（例如：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：

# 单一来源
VK_ALLOWED_ORIGINS=https://vk.example.com

# 多个来源（以逗号分隔）
VK_ALLOWED_ORIGINS=https://vk.example.com,https://vk-staging.example.com

远程部署

在远程服务器上运行 Vibe Kanban 时（例如通过 systemctl、Docker 或云托管），您可以配置编辑器通过 SSH 打开项目：

1. 通过隧道访问：使用 Cloudflare Tunnel、ngrok 或类似工具暴露 Web 界面。
2. 配置远程 SSH：在“设置”→“编辑器集成”中：
   • 将“远程 SSH 主机”设置为您的服务器主机名或 IP 地址。
   • 将“远程 SSH 用户”设置为您用于 SSH 登录的用户名（可选）。
3. 先决条件：
   • 您的本地机器必须能够通过 SSH 访问远程服务器。
   • 已配置 SSH 密钥对（实现无密码认证）。
   • 安装 VSCode Remote-SSH 扩展。

配置完成后，“在 VSCode 中打开”按钮会生成类似 vscode://vscode-remote/ssh-remote+user@host/path 的 URL，从而打开本地编辑器并连接到远程服务器。

有关详细的设置说明，请参阅文档。

Vibe Kanban 快速上手指南

Vibe Kanban 是一款专为提升 AI 编程助手（如 Claude Code、Gemini CLI、Codex 等）效率而设计的看板工具。它帮助开发者通过看板规划任务，在独立的工作空间中运行 AI 代理，并直接审查代码差异、预览应用及合并 PR。

环境准备

在开始之前，请确保你的开发环境满足以下要求：

• 操作系统：支持 macOS、Linux 及 Windows（部分功能需额外配置）。
• Node.js：版本 >= 20。
• 认证准备：请确保你已经在终端中完成了常用 AI 编程助手（如 Claude Code、GitHub Copilot 等）的登录认证。
  • 支持的助手列表详见官方文档：Supported Coding Agents

注意：若需从源码开发或构建，还需安装 Rust (最新稳定版) 和 pnpm (>=8)。普通用户直接使用 npx 即可，无需安装这些构建依赖。

安装步骤

Vibe Kanban 推荐通过 npx 直接运行，无需全局安装，确保始终使用最新版本。

在终端中执行以下命令：

npx vibe-kanban

该命令会自动下载并启动 Vibe Kanban 服务，随后在浏览器中打开界面。

基本使用

启动后，你将进入一个集成化的 AI 开发工作流。以下是核心操作流程：

1. 规划任务 (Plan)

在看板界面创建 Issue，定义你需要 AI 完成的任务。你可以对任务进行优先级排序、分配状态，就像使用传统的 Trello 或 Jira 一样。

2. 执行任务 (Run)

选中一个任务并创建工作空间（Workspace）。Vibe Kanban 会自动：

• 创建一个独立的 Git 分支。
• 启动专属终端和开发服务器。
• 调用你配置的 AI 编程助手（如 Claude Code）开始编码。

3. 审查与反馈 (Review)

AI 生成代码后，你可以在界面中直接查看 Diff（差异对比）：

• 行内评论：直接在代码行上留下反馈，AI 会根据评论进行修改。
• 应用预览：使用内置浏览器预览应用，支持开发者工具、检查模式和设备模拟。
• 切换助手：随时在不同 AI 助手间切换（支持 Claude Code, Codex, Gemini CLI, Amp, Cursor 等 10+ 种工具）。

4. 交付代码 (Ship)

当代码满意后：

• 一键生成包含 AI 描述的 Pull Request。
• 在 GitHub 上审查并最终合并代码。

极简工作流总结： 只需一条命令启动，然后遵循 描述任务 -> 审查差异 -> 发布代码 的循环。

npx vibe-kanban