vibekanban

Vibe Kanban

面向 AI 编码 Agent 的编排平台。在隔离的 git worktree 中规划、审查和管理 AI 生成的代码。

链接

• 文档
• 发行版本
• GitHub

快速导航

主题	参考文档
安装与设置	getting-started.md
工作区（Beta）	workspaces.md
项目、任务、审查	core-features.md
子任务、尝试、冲突	advanced-features.md
设置、Agent、标签	configuration.md
GitHub、Azure、VSCode、MCP	integrations.md
常见问题	troubleshooting.md
最佳实践	vibe-guide.md

快速入门

安装与运行

npx vibe-kanban

npx vibe-kanban 仍是跨平台启动的标准方式。截至 v0.1.30，打包的桌面应用正迁移到 Tauri v2 外壳，已安装的桌面版本将内置自动更新功能。

版本亮点（0.1.15 → 0.1.28）

• MCP 服务扩展：可检索更丰富的问题信息（get_issue 包含标签、关联关系和子问题），并新增工作区、关联关系和标签工具（例如 update_workspace 以及关联关系和标签变更工具）。
• 前端路由已迁移到 TanStack Router（导航和 URL 可能与旧截图不同）。
• 提升了 Electric 回退机制以及取消和切换标签页时的可靠性。
• 改进审查和差异 UI（修复了水平滚动时的批注宽度问题）。
• 远程访问：通过配对码连接主机，并从其他设备访问其工作区。
• 工作区操作在拆分和复制流程中更加安全，能够更可靠地保留分支和执行器配置。
• 现在，正在运行的 Agent 可以接收图像附件，方便在进行中的会话中提供 UI 状态、截图或设计反馈。
• 提升了传输可靠性：更好地处理中继断连，并刷新签名会话。
• Claude：将默认 Sonnet 模型升级到 4.6。
• Worktree：清理后保留 worktree 路径，以维持 Claude Code 会话的连续性。
• 工作区：改进了工作区日志捕获（根执行进程提供方）。
• 修复移动端 UI 问题并更新远程访问文档。

版本亮点（0.1.44）

• Claude Code CLI 固定版本再次更新，Codex 执行器功能也围绕 Codex 0.124.0 进行了刷新。
• 旧版项目路由即将停用，并将改为仅供导出的页面，因此旧版项目页面的深层链接或截图可能不再与当前 UX 相符。
• 规范化流式传输开始前会预先注册执行日志，从而提高运行期间日志的可用性。
• 模型选择器现在按字母顺序排列，这会改变设置和审查对话框中的一些细微但明显的操作流程。

版本亮点（0.1.37 → 0.1.43）

• 更新执行器功能，采用 Codex、OpenCode 和 Claude Code 的较新固定版本。
• Claude Code 新增 xhigh effort 变体。
• 交叉编译和运行时修复提升了 Windows/MSVC 和 musl 构建的可靠性。

版本亮点（0.1.31 → 0.1.32）

• 桌面端/Tauri：支持 Windows 桌面应用，提供 Tauri 通知，并围绕字体大小缩放重新调整桌面端缩放行为。
• 工作区：会话可以重命名并自动命名；工作区创建草稿偏好设置会持久保存。
• 附件：工作区和问题中均支持任意附件。
• MCP：可通过 MCP 界面使用问题筛选器。
• 远程/管理：新增远程审计日志，简短问题 ID 改为组织级作用域；PostHog 配置为空时会禁用分析功能。
• 编辑器体验：改进所见即所得输入提示、工具栏和问题描述编辑流程。

自动打开浏览器。使用 PORT=8080 npx vibe-kanban 可指定固定端口。

前提条件

• Node.js LTS
• 已通过身份验证的编码 Agent（Claude Code、Codex、Gemini 等）
• 用于 PR 集成的 GitHub CLI（gh）

入门步骤

1. 在外部对编码 Agent 进行身份验证
2. 运行 npx vibe-kanban
3. 完成设置对话框
4. 从现有 git 仓库创建项目
5. 添加任务并开始执行

两种 UI 模式

经典看板（任务）

采用列布局的传统看板：待办 → 进行中 → 审核中 → 已完成

v0.1.7 更新：

• 按项目划分的看板视图和焕新的筛选对话框
• 子问题和工作区可见性切换已移至筛选栏

工作区（测试版）— 新功能

现代化界面，包含：

• 会话：每个工作区可包含多个对话线程
• 命令栏：使用 Cmd/Ctrl + K 执行所有操作
• 工作区备注：记录需求和决策
• 多仓库支持：可跨多个仓库开展工作
• 集成终端：由 PTY 支持的终端，支持 shell
• 会话下拉菜单：会话标题旁显示 Agent 图标
• 侧边栏筛选器：按项目和 PR 状态筛选（包括“无项目”）
• 需要关注：包含有未查看活动的工作区

通过命令栏 →“在旧版 UI 中打开”在模式间切换

核心概念

Git 工作树

每个任务/工作区都在隔离的 git 工作树中运行：

• Agent 之间不会相互干扰
• 不受主分支变更影响
• 完成后自动清理

任务流程（经典模式）

To do → In Progress → In Review → Done

• 待办：任务已创建
• 进行中：Agent 正在执行
• 审核中：Agent 已完成，等待审核
• 已完成：已合并或 PR 已合并

任务尝试

一个任务可以有多个尝试：

• 不同的 Agent
• 不同的分支
• 全新的对话上下文

支持的 Agent

Agent	变体
Claude Code	DEFAULT、PLAN、ROUTER、XHIGH
Codex	DEFAULT、HIGH
Gemini	DEFAULT、FLASH
GitHub Copilot	DEFAULT
Amp	DEFAULT
Cursor Agent	DEFAULT
OpenCode	DEFAULT
Qwen Code	DEFAULT
Droid	DEFAULT
Antigravity	DEFAULT

创建任务尝试或工作区会话时选择 Agent。

项目配置

设置脚本

在 Agent 执行前运行（例如 npm install、cargo build）。

开发服务器脚本

启动开发服务器以供预览（例如 npm run dev）。

清理脚本

Agent 完成后运行（例如 npm run format）。

复制文件

从主项目复制到工作树的文件（例如 .env）。

创建任务

Press C or click + to create task

选项：

• 创建任务：仅添加到看板
• 创建并开始：添加任务并立即使用默认 Agent 执行

任务标签

通过 @提及 插入可重复使用的片段：

• 在描述中输入 @
• 从下拉菜单中选择标签
• 内容会插入光标所在位置

任务描述编辑器支持粘贴 Markdown，并保留行内代码格式。

代码审查

1. Agent 完成后，任务会移至“In Review”
2. 点击 Diff 图标查看更改
3. 点击任意行上的 + 添加评论
4. 一次性提交所有评论
5. 任务会返回“In Progress”，以便进行修复

Git 操作

操作	说明
合并	合并到目标分支
创建 PR	在 GitHub/Azure 上创建 PR
变基	使用目标分支的更改进行更新
推送	将其他更改推送到 PR

预览模式

无需离开 Vibe Kanban 即可测试 Web 应用：

1. 在项目设置中配置开发服务器脚本
2. 在 Preview 标签页中点击“Start Dev Server”
3. 在嵌入式 iframe 中查看应用
4. 安装 vibe-kanban-web-companion 以选择组件

键盘快捷键

按键	操作
C	创建任务
⌘/Ctrl + Enter	提交/发送消息
k/j	在列中向上/向下导航
h/l	在列之间向左/向右导航
Enter	打开任务
⌘/Ctrl + S	聚焦搜索框

MCP 集成

向 Agent 添加 MCP 服务

设置 → MCP 服务 → 选择 Agent → 添加服务

Vibe Kanban MCP 服务

向外部 MCP 客户端公开 Vibe Kanban：

{
  "mcpServers": {
    "vibe_kanban": {
      "command": "npx",
      "args": ["-y", "vibe-kanban@latest", "--mcp"]
    }
  }
}

MCP 工具包括：list_workspaces、update_workspace、list_projects、list_issues、get_issue、update_issue，以及标签和关系辅助工具。

重要安全提示

Vibe Kanban 默认使用 --dangerously-skip-permissions/--yolo 运行 Agent，以实现自主操作。每项任务都在隔离的工作树中运行，但 Agent 仍可执行系统级操作。请审查工作内容并保留备份。

重要禁令

• 首次使用前，不要跳过 Agent 身份验证
• 不要忽视工作树隔离的优势
• 不要忘记为依赖项配置设置/清理脚本
• 不要在没有新尝试的情况下让多个 Agent 处理同一任务
• 不要忽视变基冲突——请解决冲突或中止操作

链接

• 文档
• 发行版本
• GitHub
• Vibe 指南