# gtree

> 原生 macOS 应用,给同时开好几个 AI 编程 Agent 的人用(支持 Claude Code 和 Codex):同一个 worktree 里的 Agent 互相看得见、撞车时自己商量,不同 worktree 改到同一个文件会标出来;任意一轮都能恢复,新会话记得上次做到哪;所有项目一个「待处理」。

- Website: https://gtree.dobbylab.com/zh/
- Other languages: https://gtree.dobbylab.com/llms-full.txt, https://gtree.dobbylab.com/ja/llms-full.txt
- Platform: macOS, Apple Silicon. Intel Mac / Windows / Linux: planned, no dates.
- Install: `curl -fsSL https://gtree.dobbylab.com/install.sh | bash`
- Author: tzyito (独立开发者 · gtree 作者), support@dobbylab.com

## 同时开 5 个 Agent, 也知道哪个在等你。

gtree 是原生 Mac 应用,给同时开着几个 AI 编程 Agent 的人用。Agent 之间互相看得见:同一个 worktree 里的 Agent 要改同一个文件时,会先商量好谁来改;只在需要你的时候叫你。

## gtree 做的五件事

- **互相看得见** — 同一个 worktree 里的 Agent 先商量谁改;不同 worktree 改到同一个文件会标出来。
- **原生、轻快** — Rust 写的原生应用,不是 Electron。安装包 24 MB。
- **能反悔** — 每一轮改了什么都看得到,一键恢复到那一轮。
- **不用守着终端** — 要你授权或回答时才通知你,所有项目一个「待处理」。
- **跨项目联动** — 一个项目的 Agent,可以直接问另一个项目的 Agent。

### 互相看得见 — 要改同一个文件? Agent 们先商量。

多数做法是把 Agent 隔离开,互不知情。gtree 让它们知道彼此在改什么:在同一个 worktree 里,动手前先打个招呼、商量谁先改;不同 worktree(同一个仓库的另一份工作目录)改到同一个文件,gtree 会标出来。

- **同一个 worktree · 先商量** — 左边先改了 src/auth.ts。右边动手前会被告知,于是先给左边留话;左边改完自动告诉右边,右边在它的基础上接着改。Claude Code 和 Codex 之间也行。
- **不同 worktree · 标出来** — 两个 worktree 都还没提交、却改到了同一个文件时,侧栏那一行出现琥珀色 △,开始页点「看是哪些」就能对比。

### 原生、轻快 — 不是 Electron, 是 24 MB 的原生应用。

gtree 用 Rust 写,界面用 GPUI(Zed 编辑器的 UI 框架)在 GPU 上直接绘制。不带浏览器、不带 Node,点开就是一个原生窗口。

- 读 git 用 gitoxide(纯 Rust);提交、推送交给你电脑上的 git,SSH key 和 hooks 照常生效
- 长列表只画看得见的那几行,重的 git 操作放在后台,界面不卡

### 能反悔 — 改坏了? 回到任意一轮。

Agent 每答完一轮,gtree 都记下这一轮改了哪些文件。在右边「改动」→「AI 每一轮」里逐轮看 diff;哪一轮不对,点「恢复到这一轮」。

- 只把这一轮动过的文件恢复到它结束时的样子,别的文件、分支和暂存区都不动
- 要点两次才生效,不怕手滑;每一轮 30 天内都能恢复
- 新会话一开头就知道这个 worktree 上次做到哪

### 不用守着终端 — 去忙别的吧, 需要你时它会叫你。

gtree 替你盯着。Agent 要你授权、要你回答时,发一条 macOS 通知;所有项目里在等你的事,都排在「待处理」最前面,点一下就进到那个会话。

- 只在需要你时提醒:要授权、要回答;Claude Code 答完你一直没回,也会提醒
- 你正看着那个会话时,不打扰
- 点通知直达那个 worktree;gtree 开着就行,窗口关了也会提醒

### 跨项目联动 — 前端的 Agent, 可以直接问后端的 Agent。

在「待处理」里展开「项目关系图」:每个项目里谁在干活、项目之间谁依赖谁、哪两个 Agent 正在说话,都在一张图上。拿不准另一个项目的接口时,Agent 可以直接去问那边的 Agent。

- 回答的是对方会话的一个副本,在后台回答,不打断对方手上的活
- 自动认出 Cargo、npm、Go 里互相引用的项目;接口调用这类代码里看不出的,也能手动加上
- 能被提问的,目前只有 Claude Code 的会话

### 队友:看到同事还没推送的代码 (个人版 · 免费 · 默认关)

和同事共用一个仓库时打开「队友」,通过你们自己的 git 仓库同步,看到队友还没推送的改动。你的 Agent 要改到队友正在改的地方,会先停下来问你。

- 按仓库打开,双方都开了才互相看得见
- 打开后,你没提交的改动会同步到你们自己的团队仓库(不经过 gtree 的服务器),有仓库权限的人都看得到;随时可以关
- 「先停下来问你」目前只有 Claude Code 支持

### 原生、轻快

- 安装包: 24 MB
- 装好后的大小: 73 MB
- 从点开到出现窗口: ≈0.2 秒
- 空闲时的内存: ≈100 MB
- 空闲时的 CPU: <1 %
- Apple M4 · macOS 15 · gtree 0.3.14 实测(CPU 为 0.3.15)。开窗时间是热启动 7 次的中位数(176 毫秒);内存按「活动监视器」口径;CPU 是单核 20 秒平均。

## 只开几个终端,做不到这些。

- 同一个 worktree 的 Agent 改同一文件前互相知道、自己商量 (只开终端 / tmux: 各改各的,互相不知道)
- 不同 worktree 改到同一个文件,提交前就标出来 (只开终端 / tmux: 合并时才发现)
- 所有项目在等你的事,一个列表 (只开终端 / tmux: 一个个终端切过去找)
- 只在要你授权、要你回答时通知你,点一下直达 (只开终端 / tmux: 终端会响,但看不出是哪个项目的哪个 Agent)
- 一个项目的 Agent 去问另一个项目的 Agent (只开终端 / tmux: 你在中间来回转述)

## 也是一个顺手的 Git 客户端。

- **开始页给出下一步** — 没推送、落后 main、还没有 MR —— 每种情况旁边就是对应的按钮:推送、变基、创建 MR。
- **提交历史与 MR 状态** — 所有分支一张泳道图,AI 每一轮也能叠在图上看;侧栏分支名后面直接显示 MR 状态。
- **任意两端对比** — 任选两个分支或提交,看它们差在哪。
- 支持 Claude Code 和 Codex。Claude Code 是最先支持、集成最深的。

## 定价

### 个人版 — $0 (永久)

- Agent 互相看得见、撞车前先商量
- 任意一轮都能恢复 + 跨会话记忆
- 通知 + 所有项目一个「待处理」
- 跨项目 Agent 互问 + 项目关系图
- 历史对话搜索 ⌘Y
- Git 客户端:开始页、MR 状态、任意两端对比
- 队友(经你们自己的 git 仓库,默认关)
- 无需登录
- gtree 不上传你的代码

### 团队版 — 开发中

个人版的全部,再加:
- 团队 Diff 与批注 (开发中)
- 队友的改动实时同步(不用等 git 推拉) (设计中)
- 两人改到同一处时,双方一起拿主意 (设计中)
- 团队消息经中转几秒就到,不用等 git 同步 (设计中)
- 中转服务器只转发同步信息,不存储数据
- 团队想用,或需要私有部署?告诉我们你们需要什么。 support@dobbylab.com

## 为什么信得过

- **gtree 不上传你的代码** — gtree 只在你的电脑上读写仓库。不用注册账号,gtree 不上传你的代码。
- **改仓库走的是你自己的 git** — 提交、推送、变基都交给你电脑上的 git 执行:凭证、SSH key、hooks 照常生效,什么都不用重新配。
- **原生应用,不带浏览器引擎** — Rust 写的,GPU 绘制,不带浏览器、不带 Node。安装包 24 MB,约 0.2 秒开窗(热启动),空闲时内存约 100 MB。
- **匿名统计可以关** — 只匿名统计有多少人在用、用的是哪个版本,对应不到你本人;第一次打开时会告诉你,随时可以在设置里关掉。

## 常见问题

### 免费版有什么限制?以后会收费吗?

个人版没有功能限制。所有在你电脑上跑的功能 —— Agent 互相看得见、任意一轮都能恢复、跨会话记忆、「待处理」和项目关系图、历史对话搜索、Git 客户端、队友 —— 永久免费,以后也不会改成收费。要收费的只有需要服务器的团队功能。

### 团队版什么时候上线?多少钱?

团队版还在开发,现在还没有上线日期和价格。如果你们团队想用,或需要私有部署,发邮件到 support@dobbylab.com,告诉我们你们需要什么。

### 我的代码会上传吗?

gtree 不会上传。它只在你的电脑上读写仓库,不会把你的代码、对话内容和文件路径传给我们。和 AI 的对话由你自己的 Claude Code 或 Codex 发给 Anthropic 或 OpenAI,按各自的条款处理 —— 这部分和不用 gtree 时一样。打开了「队友」的仓库,还在写的代码会推到你们团队自己的 git 仓库,不经过我们。团队版会多一台中转服务器,它只转发同步信息,不存储数据。

### 我只用一个 Agent、也不用 worktree,它对我有用吗?

有。任意一轮都能恢复、⌘Y 搜历史对话、新会话记得上次做到哪、开始页上的 Git 按钮、任意两端的 Diff,只开一个 Agent 时同样好用。等你哪天想同时开第二个,它已经在那了。

### 和直接开几个终端或 tmux 有什么区别?

终端和 tmux 管的是窗口,不知道里面的 Agent 在干什么。gtree 认得出每个 Agent 是在干活、在等你还是已经空闲,答完了你一直没回也会提醒,只在需要你时打扰你。它还知道每个 Agent 改了哪些文件:同一个 worktree 里的两个 Agent 动手前会被告知对方改过什么,自己商量谁先改;不同 worktree 改到同一个文件,侧栏会标出来。终端也还在 —— 每个 worktree 可以开一个或几个(⌘T 再开一个),里面跑的就是 claude 或 codex 本身。

### 支持 Codex、Cursor 等其他 Agent 吗?

支持 Claude Code 和 Codex。Claude Code 是最先支持、集成最深的;Codex 会话同样会报告状态、在等你时出现在「待处理」、记下每一轮、收到撞车提醒;接着聊以前的对话、回答别的项目的提问,目前只有 Claude Code 支持。两者都要先在设置里连上一次。其他 Agent 暂时还不支持 —— 想要哪个,可以写信告诉我们。

### 它重吗?

不重。它是原生应用 —— Rust + GPUI,GPU 绘制 —— 不是 Electron,也不带浏览器引擎。安装包 24 MB,约 0.2 秒开窗(热启动),空闲时内存约 100 MB(M4 Mac 上实测)。

### 我的 git 配置、SSH key、hooks 还能用吗?

能。所有改仓库的操作(提交、推送、拉取、变基、合并…)都交给你电脑上的 git 执行,完整继承你已经配好的凭证、SSH key、pre-commit hooks 等。

### 会收集数据吗?

不会收集你的代码、文件、仓库信息和对话内容。我们只匿名统计有多少人在用、用的是哪个版本,不能对应到你本人。第一次打开时会告诉你,随时可以在设置里关掉。

### Intel Mac、Windows、Linux 什么时候支持?

目前只有 macOS 的 Apple Silicon 版本。Intel Mac、Windows 和 Linux 在计划里,还没有具体日期。

## 谁在做 gtree

嗨,我是 tzyito 👋 我每天同时开好几个 Agent,受够了来回切终端找谁在等我,就做了 gtree。
现在我每天用 gtree 开发 gtree 本身。

## 博客

- [Claude Code 在等你授权?怎么第一时间知道](https://gtree.dobbylab.com/zh/blog/claude-code-waiting-for-approval-notifications/index.md) (2026-10-13) — Claude Code 一要授权就停下来干等。教你用 Notification hook 发系统通知,以及多开时怎么一屏看清哪个 Claude 在跑、哪个在等你。
- [Claude Code 多开:用 git worktree 同时跑多个 AI](https://gtree.dobbylab.com/zh/blog/run-multiple-claude-code-git-worktree/index.md) (2026-10-10) — 想同时开好几个 Claude Code 改同一个仓库?给每个会话一个 git worktree 就不会互相覆盖。这里有能直接用的命令、常见的坑,以及怎么省掉这些重复操作。

## 版本说明

- v0.3.15 (2026-10-15) — agent 干活时更省 CPU,发给 agent 的话也有英文了
- v0.3.14 (2026-10-15) — 重开还是关闭前的样子,点一下就能看 diff
- v0.3.13 (2026-10-14) — 右边面板更清楚:标签一眼看出能切换,提交信息框随内容变高
- v0.3.12 (2026-10-14) — 新布局:点一条线就知道下一步做什么,侧栏显示 MR 状态
- v0.3.11 (2026-10-13) — 工作台一眼看出先管哪个,「待处理」重做
- v0.3.10 (2026-10-10) — 打开的文件可以直接改了
- v0.3.9 (2026-10-10) — 连上 Codex,agent 之间自己商量,新增「队友」
- v0.3.8 (2026-10-09) — 新增「待处理」和系统通知,导航收成 4 项
- v0.3.7 (2026-10-09) — gtree 放在哪都行,Claude Code 集成不会失效
- v0.3.6 (2026-10-09) — 新用户安装当天就能正确计入使用统计
- v0.3.5 (2026-10-09) — 浏览器下载的安装包也能顺利打开
- v0.3.3 (2026-10-09) — 在设置里一键接入 Claude Code
- v0.3.2 (2026-10-09) — 界面支持英文和日文,新增首次启动引导
- v0.3.1 (2026-10-08) — 新增设置面板,随时开关匿名使用统计
- v0.3.0 (2026-10-08) — 时间线:AI 每一轮的改动都能回看、能恢复
- https://gtree.dobbylab.com/zh/release-notes/index.md

## 隐私政策

gtree 在你的 Mac 本地运行,不会上传你的代码。只发送匿名使用统计(随机 ID、版本、CPU 架构、macOS 版本),随时可以关闭。
- https://gtree.dobbylab.com/zh/privacy/index.md