worktree

A Git worktree management command for creating and organizing multiple working directories from one repository.

In plain words
What is it for?
Use it to add, list, remove, or prune worktrees, open one in an IDE, track a remote branch, or migrate changes between worktrees.
Why use it?
It makes it easier to work on separate branches at the same time without repeatedly switching the main checkout.

Command

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add commands/qinye6/pi-ccg/worktree
Clone the repo
git clone --depth 1 https://github.com/qinye6/pi-ccg
Per session 26 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 861 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin 100% copy Near-identical to another mod in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00026 $0.00861
Opus 5 $0.00013 $0.00430
Sonnet 5 $0.00005 $0.00172
Haiku 4.5 $0.00003 $0.00086

Measured 2d ago against content hash 8a7ac115bb5b, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

worktree scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

This is a copy

100% identical to worktree — 0 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

templates/commands/worktree.md · 129 lines

What it actually says

Worktree - Git Worktree 管理

在结构化目录管理 Git worktree,支持智能默认和 IDE 集成。

使用方法

/worktree <add|list|remove|prune|migrate> [options]

子命令

命令 说明
add <path> 创建新 worktree
list 列出所有 worktree
remove <path> 删除指定 worktree
prune 清理无效引用
migrate <target> 迁移内容到目标 worktree

选项

选项 说明
-b <branch> 创建新分支
-o, --open 创建后用 IDE 打开
--from <source> 迁移源路径
--stash 迁移 stash 内容
--track 跟踪远程分支
--detach 分离 HEAD
--lock 锁定 worktree

目录结构

parent-directory/
├── your-project/           # 主项目
│   ├── .git/
│   └── src/
└── .ccg/                   # worktree 管理目录
    └── your-project/
        ├── feature-ui/     # 功能分支
        ├── hotfix/         # 修复分支
        └── debug/          # 调试 worktree

执行工作流

Add - 创建 Worktree

[模式:创建]

  1. 验证 Git 仓库
  2. 计算路径:../.ccg/项目名/<path>
  3. 创建 worktree
  4. 自动复制环境文件(.env 等)
  5. 可选:用 IDE 打开

Migrate - 迁移内容

[模式:迁移]

  1. 验证源有未提交内容
  2. 确保目标干净
  3. 显示即将迁移的改动
  4. 安全迁移
  5. 确认结果

示例

# 基本创建
/worktree add feature-ui

# 创建并用 IDE 打开
/worktree add feature-ui -o

# 创建指定分支
/worktree add hotfix -b fix/login -o

# 迁移未提交内容
/worktree migrate feature-ui --from main

# 迁移 stash 内容
/worktree migrate feature-ui --stash

# 管理操作
/worktree list
/worktree remove feature-ui
/worktree prune

输出示例

✅ Worktree created at ../.ccg/项目名/feature-ui
✅ 已复制 .env
✅ 已复制 .env.local
📋 已从 .gitignore 复制 2 个环境文件
🖥️ 是否在 IDE 中打开?[y/n]: y
🚀 正在用 VS Code 打开...

智能特性

  1. 智能默认 – 未指定分支时使用路径名
  2. IDE 集成 – 自动检测 VS Code / Cursor / WebStorm
  3. 环境文件 – 自动复制 .gitignore 中的 .env 文件
  4. 路径安全 – 始终使用绝对路径防止嵌套问题
  5. 分支保护 – 验证分支未被其他地方使用

注意事项

  • Worktree 共享 .git 目录,节省磁盘空间
  • 迁移仅限未提交改动,已提交内容用 git cherry-pick
  • 支持 Windows、macOS、Linux
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 129 lines · 26 tokens per session scan A 8a7ac115bb5b

Subscribe to this mod's changes

worktree is a command published in the GitHub repository qinye6/pi-ccg (10 stars, last pushed 8d ago), licensed MIT. It adds 26 tokens to every session and 861 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. It is 100% identical to worktree, differing in 0 lines, and is treated as a copy.