安装

下载安装，装好之后在跑什么，以及怎么更新。

下载

Kumo.dmg， 打开后把 Kumo 拖进 Applications。App 已签名并公证，双击就能打开，macOS 不会把你送去系统设置里放行。

需要一台 Apple Silicon Mac，系统 macOS 13 或更新。没有 Intel 版本，也没有 Windows 版本。Kumo 不在 Mac App Store 上架，因为沙盒撑不住它维持 agent 进程的方式。

你还需要至少装好并登录一个 agent CLI。Kumo 不自带，见配置 agent。

第一次启动

窗口是空的。Kumo 不会扫描你的磁盘找仓库。

1. 导入一个 project：点中间那个按钮，或者 PROJECTS 旁边的文件夹图标。
2. 在树里选一个 Workspace。agent 得有地方跑，那个地方是 Workspace，不是 project。git 仓库的主目录就是第一个 Workspace。
3. 按 tab 栏里的 +（或 ⌘N），点一个 agent，开始打字。

整个流程就这些。这份文档剩下的部分，讲的都是怎么同时跑更多 agent。

装好之后在跑什么

两个进程：

• runtime 负责干活：它管着 project、Workspace 和 agent 的登记表，把你的 prompt 排队，跑 git，并和每个 agent 保持连接。只要它还活着，菜单栏里就有一个 Kumo 图标。
• 工作台窗口只是个客户端，通过本地 Unix socket 和 runtime 通信。不会开任何端口。

正因为这样拆分，关掉窗口才是安全的。⌘Q、红点、Dock 里的 Quit，关掉的都是窗口；agent 继续跑，菜单栏图标还在。点菜单栏图标，或者从 Dock 再打开 Kumo，窗口就回来了。

要停掉所有东西（agent、终端、runtime、窗口），右键点菜单栏图标，选 Quit Kumo。它会先问你一次，因为这会停掉正跑到一半的 agent。

每个 agent 的进程由各自的小 holder 进程托管，所以连 runtime 重启都扛得住。App 自我更新时，你手上正在跑的东西一样不会丢。

更新

Kumo 在窗口打开时检查新版本，之后每四小时查一次。有新版本时，右侧栏 Settings 上方会出现一个绿色下载按钮。点它，依次是 Kumo 0.26.0 is available、进度条、Restart。也可以在 Settings → About → Check for updates 手动检查。

你不按 Restart，什么都不会动。 到这一步新 app 已经就位，Restart 只是把窗口重新拉起来。之前跑着的 agent 全程继续跑，新窗口会悄悄把旧 runtime 换成自己带的那份。

Kumo 把东西放在哪

对话不存在这里。Kumo 不保留你和 agent 对话的第二份副本，历史由你当时用的那个 CLI 从它自己的 session 文件里回放。

卸载

在菜单栏 Quit Kumo，然后把 app 拖进废纸篓。想把登记表也删掉，就删 ~/Library/Application Support/kumo/ 和那两个日志文件。你的仓库和 worktree 不受影响。

公测期间

到 2026 年 11 月 1 日之前，所有功能解锁，也不需要注册账号。之后有什么变化，见设置、快捷键与套餐。