搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

leostera/git-twig

开发工具

用写时复制创建 Git 工作树,帮并行 Agent 减少磁盘占用的 Git 扩展。

127
2
Rust
MIT
创建于 1 天前

项目介绍

git twig 是一个 Git 子命令,用写时复制(CoW)创建链接式工作树,而不是完整复制文件。它面向需要并行创建大量工作树的编程 Agent 场景,用更多创建时间换取明显更少的磁盘占用;在不支持的文件系统或版本模式下,会退回普通 git worktree。

它只从已提交文件创建工作树,本地改动和忽略文件不会被复制。Twig 会按请求的 commit 校验克隆出的文件,写入是私有的,不会与源目录硬链接。

安装与创建第一个工作树

需要 Git 2.40+;从 crates.io 安装还需要 Rust 1.95+。用 Homebrew 安装:

brew tap leostera/git-twig https://github.com/leostera/git-twig
brew install leostera/git-twig/git-twig

或从 crates.io 安装:

cargo install git-twig --locked

假设已有检出目录 main/,为 HEAD 上的 feat/x 分支在 ../feat-x 创建工作树:

git -C main twig new -b feat/x ../feat-x HEAD
git -C main twig list

完成后会得到一个已注册的普通链接工作树,可继续使用常规 Git 命令。git twig -h 和 git twig new --help 可在检出目录外使用,git twig skill 会输出内置的 Agent 技能说明。

文件系统与正确性约束

原生 CoW 要求 macOS/APFS,或 Linux 上的 Btrfs、启用 reflink 的 XFS;常见 ext4 会退回 git worktree。源目录、目标目录和 Git 元数据必须位于同一支持克隆的文件系统。只有源检出的当前 HEAD 支持原生 CoW,其他版本走 Git 路径。设置 TWIG_TRACE=1 可以查看实际选用的后端。

暂存数据位于公共 Git 目录下的 twigs/staging,成功后会删除。失败或中断可能保留暂存目录和一个部分注册的工作树,重试前应先检查。

性能与限制

公开基准同时比较创建时间和额外磁盘占用。在较小起始仓库上,twig 慢 3.30 倍但省 1.6 倍空间;在 Axo 上快 2.02 倍并省 18.8 倍空间;连续创建 10 个 Linux 内核工作树时慢 1.40 倍但省 34.2 倍空间。各行批量不同,数字不能直接横向比较。方法见基准设置与原始结果和 Linux 测量。

空间收益取决于文件系统,因此在默认 ext4 环境中主要优势不会出现;在较小仓库上创建更慢,说明这种交换更适合大型检出或大量并行工作树。

HotRepo 点评

HotRepo 目前只记录了 2026-11-16 新项目榜的一次快照:git-twig 为 128 Star,约一小时的观察窗口内净增 18 Star。单一短窗口不足以判断趋势,但它让项目出现在关注 Agent 相关 Git 工具的开发者面前。技术上值得注意的分界是:省盘效果依赖文件系统,而回退行为保持与现有工作树兼容,读者可以在自己的文件系统上评估,而不是假定基准比例处处适用。

本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。

相关推荐

  1. max-sixty/worktrunk把 Git worktree 变成按分支操作的命令,让并行的 AI 编程代理各用一个独立目录。Rust9,457
  2. stencil-hq/ovnfs为编码 Agent 提供任意目录的隔离写时复制检出,不复制原目录,审查后再合并回去。Go105
  3. go-git/go-git让 Go 程序在进程内完成克隆、读取与写入仓库,而无需调用 git 二进制。Go7,830
  4. gitbutlerapp/gitbutler一个同时提供图形界面和命令行的 Git 客户端,用堆叠分支和并行分支替掉手动 rebase,适合同时推进多个改动的开发者。Rust21,849
  5. jesseduffield/lazygit把 Git 的暂存、变基和历史修改变成终端里可键盘操作流程的工具。Go83,495