Vibe Kanban

Vibe Kanban是一款专为AI编程代理（Claude Code、Gemini CLI等)打造的可视化看板工具，核心定位是解决AI编程过程中乱改代码、改动不透明、多任务混乱、失去控制等核心痛点，通过「隔离执行+可视化评审+审批合并」的流程，让AI编程从“失控”变为“可控”，同时协调多个编码代理并行工作，大幅提升AI编码效率。

它的核心理念是「规划 → 隔离执行 → 审查 → 合并」，不再让AI直接操作主项目代码，而是通过看板管理任务、Git分支隔离改动、逐行评审成果，最终由人类工程师审批后合并，既发挥AI编码的高效性，又保障项目代码的安全性与规范性，是2026年AI编程标配时代的必备管控工具。

AI编程的核心痛点与Vibe Kanban解决方案

当前AI编程虽已普及，但存在诸多影响项目安全与开发效率的痛点，Vibe Kanban针对每个痛点提供了精准的解决方案，形成完整的管控闭环：

核心功能：管控+协调+高效，覆盖AI编程全流程

Vibe Kanban围绕AI编程的全流程，打造了一系列实用功能，既实现对AI代理的有效管控，又能提升整体编码效率，核心功能如下：

1. 多编码代理灵活切换与协调

• 支持无缝切换Claude Code、Gemini CLI、Codex、Amp等主流AI编码代理，无需重复配置环境与身份验证；
• 可协调多个编码代理并行或顺序执行任务，例如让A代理处理前端页面、B代理处理后端接口，提升多任务处理效率；
• 集中配置所有编码代理的MCP（模型上下文协议）参数，统一管理代理的运行规则，减少重复配置工作。

2. 可视化看板任务管理

• 以Kanban看板形式规划和追踪AI编程任务，任务状态清晰可查（待执行、执行中、待评审、已完成）；
• 支持任务创建、编辑、拖拽切换状态，轻松规划AI编程流程，无需复杂的命令行操作；
• 实时跟踪任务进展，了解AI编码代理的工作进度，及时发现停滞或异常任务。

3. 隔离执行与可视化代码评审

• 基于Git Worktree实现任务代码隔离，每个任务拥有独立的工作空间，改动不会影响主项目代码，保障项目安全；
• 提供可视化代码差异对比工具，逐行查看AI生成/修改的代码，快速识别不合理改动、语法错误或逻辑问题；
• 支持快速启动开发服务器，运行AI生成的代码，验证功能是否符合预期，评审更全面。

4. 审批合并与远程部署支持

• 采用「AI执行，人类审批」的流程，只有工程师评审通过后，才能将任务分支的代码合并到主分支，掌握最终控制权；
• 支持远程服务器部署，可通过Cloudflare Tunnel、ngrok等工具暴露Web UI，配合SSH配置实现本地编辑器（VS Code）远程打开项目；
• 配置SSH免密认证与VS Code Remote-SSH扩展后，可直接在本地编辑远程服务器上的AI生成代码，操作便捷。

快速上手：一键安装，即刻使用

Vibe Kanban支持通过npx一键安装，无需复杂的环境配置，步骤如下：

步骤1：前置准备

• 确保已完成对应AI编码代理（Claude Code、Gemini CLI等）的身份验证，避免使用时出现权限问题；
• 确认终端可正常访问npm仓库，支持npx命令（Node.js ≥18环境自带）。

步骤2：一键安装并启动

在终端中直接运行以下命令，即可安装并启动Vibe Kanban：

npx vibe-kanban

步骤3：开始使用

• 启动后将自动打开Web UI，可在看板中创建首个AI编程任务；
• 选择对应的编码代理，配置任务需求，提交后AI将在隔离分支中执行任务；
• 任务完成后，在看板中查看代码差异，评审通过后合并到主分支，完成整个AI编程流程。

提示：如需详细功能使用指南，可访问Vibe Kanban官方文档获取最新信息。

开发环境搭建：源码级二次开发与调试

如需对Vibe Kanban进行二次开发或调试，可搭建本地开发环境，步骤如下：

1. 前置条件（必须满足）

• 安装最新稳定版Rust（后端开发语言）；
• 安装Node.js ≥18与pnpm ≥8（前端依赖管理与构建）；
• 配置好Git环境，支持Git Worktree命令。

2. 安装额外开发工具

# 安装Rust热重载工具
cargo install cargo-watch

# 安装SQLx命令行工具（数据库操作）
cargo install sqlx-cli

3. 克隆源码并安装依赖

# 1. 克隆源码仓库（需替换为官方源码地址）
git clone https://github.com/vibe-kanban/vibe-kanban.git
cd vibe-kanban

# 2. 安装项目依赖
pnpm i

4. 运行开发服务器

pnpm run dev

• 该命令将启动后端服务，同时自动从dev_assets_seed文件夹复制空白数据库；
• 前端默认运行在3000端口，后端运行在3001端口，可通过http://127.0.0.1:3000访问Web UI。

5. 前端构建与源码打包（macOS）

# 仅构建前端项目
cd frontend
pnpm build

# macOS环境从源码打包（生成可执行文件）
./local-build.sh

# 测试打包结果
cd npx-cli && node bin/cli.js

关键配置：环境变量与远程部署

1. 核心环境变量配置

Vibe Kanban支持构建时与运行时两种环境变量配置，核心变量如下表：

提示：构建时变量需在pnpm run build前设置，运行时变量可在启动应用前通过终端导出或配置在服务脚本中。

2. 反向代理/自定义域名部署（关键配置）

当Vibe Kanban运行在Nginx、Caddy等反向代理后，或使用自定义域名时，必须配置VK_ALLOWED_ORIGINS，否则会出现API请求403错误：

# 单个自定义域名
VK_ALLOWED_ORIGINS=https://vk.example.com

# 多个域名（逗号分隔，无空格）
VK_ALLOWED_ORIGINS=https://vk.example.com,https://vk-staging.example.com

3. 远程部署与SSH配置

1. 暴露Web UI：使用Cloudflare Tunnel、ngrok等工具，将远程服务器上的Vibe Kanban端口暴露到公网，便于访问Web UI；
2. 配置远程SSH：
   • 进入Vibe Kanban设置 → 编辑器集成，填写「Remote SSH Host」（服务器IP/主机名）与「Remote SSH User」（SSH用户名）；
   • 确保本地机器已配置SSH密钥免密认证，可直接登录远程服务器；
3. 本地编辑器集成：安装VS Code Remote-SSH扩展，点击看板中的「在VS Code中打开」，即可本地连接远程服务器并打开项目，编辑AI生成的代码。