安装
KanVibe 以 macOS 桌面应用形式分发，推荐通过 Homebrew Cask 安装。
前置条件
| 依赖 | 是否必需 | 用途 | 安装示例 |
|---|---|---|---|
| Git | 必需 | 创建和清理 branch、worktree | brew install git |
| tmux | 推荐 | 默认会话后端。把会话类型改为 terminal 后即可不装 | brew install tmux |
GitHub CLI gh | 必需 | PR URL 查询与 GitHub 工作流 | brew install gh，然后 gh auth login |
| zellij | 可选 | 可替代 tmux 的会话后端 | brew install zellij |
若不想使用多路复用器，可选择 terminal 会话类型。此时 shell 由 KanVibe 直接持有，应用退出或远程连接断开时，正在运行的工作也会一并消失。如果打算让任务长时间无人值守地运行，建议安装 tmux 或 zellij。
使用 Homebrew 安装
brew install --cask rookedsysc/kanvibe/kanvibe
open -a KanVibe当 KanVibe 进入官方 Homebrew Cask 后，可使用：
brew install --cask kanvibe更新与卸载
brew update
brew upgrade --cask kanvibebrew uninstall --cask kanvibe
brew untap rookedsysc/kanvibe首次运行清单
1. 注册项目
点击看板工具栏上的放大镜目录扫描按钮，并选择本地或远程 git 仓库。KanVibe 会扫描已有 worktree 分支。
2. 确认会话类型
默认使用 tmux；偏好 zellij 时可在设置中切换默认会话类型；若完全不想使用多路复用器，可选择 terminal。
3. 允许通知
启用系统通知后，AI 代理 hooks 的状态变化会立即显示。