// 文档

geetree 命令

在终端里用 geetree 打开仓库、在比较窗口里看工作区的改动，以及怎么把这个命令装到 PATH 上。

用法

geetree [<dir>]                     打开 <dir>（默认当前目录）所在的仓库，停在提交页
geetree compare [--wait] [<path>]   在比较窗口里看工作区的改动（给了 <path> 就只看它下面的）

选项：

  • -w, --wait：和 compare 一起用，等比较窗口关掉之后才返回
  • -h, --help：用法
  • -V, --version：版本号

diff 是 compare 的别名。-- 之后的参数一律当成路径，哪怕它正好叫 compare。

命令本身不开新窗口：它把请求交给已经在运行的 GeeTree；没有在运行就起一个，并且和终端分开——终端关掉，应用照常留着。

几个例子

geetree                       # 当前目录所在的仓库
geetree ~/code/linux          # 另一个仓库
geetree compare               # 工作区所有改动
geetree compare src/main.rs   # 只看这个文件
geetree compare --wait        # 等比较窗口关掉再继续（脚本里有用）

当前目录不在任何 git 仓库里时，geetree 会直接打开 GeeTree 的首页并在终端里说明；geetree compare 则会报错退出，因为没有工作区可比。

安装

在「偏好设置 → 通用」里点「安装 geetree 命令…」。它在 PATH 上放一个启动器，指向当前这份应用：

  • macOS：/usr/local/bin/geetree（通过 /etc/paths 在每个 shell 的 PATH 上）。这个目录不属于当前用户时会要一次管理员密码。
  • Linux：~/.local/bin/geetree。AppImage 的启动器运行的是镜像文件本身，不是它的挂载点。
  • Windows：GeeTree 本地数据目录里的 geetree.cmd，并把该目录加进当前用户的 Path。

同名文件如果不是它自己写的，既不会被覆盖也不会被删除。应用被移动过，或者装了两份，偏好设置里会显示命令指向的是另一份——再点一次安装就改到当前这份。macOS 上如果应用是从 dmg 或者临时位置运行的，要先拖进「应用程序」才能安装这个命令。

最后更新：2026-10-27