Manage Git worktrees per writer for Agent Toolkit swarms — isolated branches, handoff promotion,.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Worktree
Create and maintain **worktree-per-writer** isolation for `agent-toolkit swarm` so each role works on its own branch without stepping on others. Integrates with `swarm-handoff` promotion and `github-cli-workflow` for PRs.
## When to use
- Swarm needs isolated writes: implementer, reviewer, integrator each own a worktree/branch.
- `worktree_failed` trace or `find_repo_root` error on `.git` file worktrees.
- Before `swarm promote` — ensure the handoff's worktree is clean and pushable.
- Cleanup after a run is promoted or abandoned.
## Prerequisites
- Repo is Git with `git worktree` available (`git worktree --help`).
- Swarm run exists: `.agent-toolkit/swarm/runs/<run-id>/state.json`; worktrees live under `.agent-toolkit/swarm/runs/<run-id>/worktrees/<role>-<short>/`.
- `find_repo_root` uses `git rev-parse --git-common-dir` to handle worktree `.git` files (not directories).
## Workflow
### 1. Inspect current worktrees
```bash
git worktree list
agent-toolkit swarm status --run-id <run-id> --json | jq '.worktrees'
# Expected: {implementer: {path, branch, commit}, reviewer: {path, branch}, ...}
…
The line at the top of this page pins the label v1.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
GET https://markdownregistry.com/api/v1/artifacts/art_qdtpae2kwfmjgcwm
GET https://markdownregistry.com/api/v1/resolve?ref=ulises-jeremias/agent-toolkit/worktree
GET https://markdownregistry.com/api/v1/blob/7303ece6d351b143b6445ff41e5e84b10173d207e4bb8cb98ec829bc2500eece
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
ulises-jeremias/agent-toolkit · plugins/agent-toolkit-complete/.github/skills/adr/SKILL.md · WHAT — Create and maintain Architecture Decision Records (ADRs) per the process. Covers when
ulises-jeremias/agent-toolkit · plugins/agent-toolkit-complete/.github/skills/blast-radius/SKILL.md · Find what a change could break somewhere else before it ships, beyond the diff, and prove
ulises-jeremias/agent-toolkit · plugins/agent-toolkit-complete/.github/skills/brag-slim/SKILL.md · Turn a project directory or a website URL into a short, shareable launch video with music, motion, and share copy. One…
ulises-jeremias/agent-toolkit · plugins/agent-toolkit-complete/.github/skills/brag/SKILL.md · Turn the current project website into a short, polished, shareable launch video using Hyperframes. Use when someone…
ulises-jeremias/agent-toolkit · plugins/agent-toolkit-complete/.github/skills/bug/SKILL.md · WHAT - Draft and review bugs using the Bug Template; classifies whether an issue should be
imran31415/kube-coder · .claude/skills/worktree/SKILL.md · Create an isolated git worktree + branch + port for this session so concurrent kube-coder sessions and builds don't…
shibing624/agentica · agentica/skills/bundled/worktree/SKILL.md · Isolate parallel work in a git worktree of the current repository (worktree tool: status / new / merge / remove). Use…
oprogramadorreal/optimus-claude · skills/worktree/SKILL.md · Creates a git worktree for isolated parallel development — new branch in a separate directory with project setup and…
outlinedriven/odin-claude-plugin · plugins/odin-git/skills/worktree/SKILL.md · Use when work needs an isolated git worktree: new work, an existing ref, a gated feature workspace, a manifest-tracked…
hidorakai002/ai-workspace-archive · ai_agent_frameworks/major_frameworks/AutoGPT/.claude/skills/worktree/SKILL.md · Set up a new git worktree for parallel development. Creates the worktree, copies .env files, installs dependencies, and…
byerlikaya/claude-starter-kit · kit/skills/worktree/SKILL.md · Isolate risky or parallel file-mutating work in a git worktree so the main tree's uncommitted changes are…
byerlikaya/claude-starter-kit · plugin/skills/worktree/SKILL.md · Isolate risky or parallel file-mutating work in a git worktree so the main tree's uncommitted changes are…
