Skip to content

References: Worktrees and parallel agents

  • Git official documentation, the git-worktree(1) man page. The authoritative reference for all worktree commands, options, and edge cases. Worth reading once end-to-end if you intend to use worktrees seriously. Available at git-scm.com/docs/git-worktree.
  • Pro Git by Scott Chacon and Ben Straub, 2nd edition. Worktrees and the wider Git tooling are covered in Chapter 7 (Git Tools); the book predates the most common multi-agent use cases, so it treats worktrees lightly. Licensed under Creative Commons Attribution Non Commercial Share Alike 3.0 Unported. Available free at git-scm.com/book. Treat the official man page as primary; Pro Git as supplementary.
  • “Bare-repo plus worktrees”, community write-ups on using git clone --bare as the backbone for an all-worktree workflow (no “primary” working tree). Heavier setup but interesting once you’re comfortable with basic worktrees.
  • “Worktrees with multiple AI agents”, emerging 2026 community write-ups on the parallel-agent pattern. The Clawless 2026-06-04 sprint write-up is one such reference and covers the per-agent worktree pattern at production scale.
  • “Worktree limitations and gotchas”, community discussions on the edge cases (submodules, hooks, locking strategies for shared disks). Worth reading once if your workflow uses any of those.
  • Various IDE-specific guides. VS Code, JetBrains IDEs, etc. publish guides on opening multiple worktrees as a workspace.

L13’s worktree mechanics, commands, and constraints follow the git-worktree(1) man page directly. The four canonical use cases are synthesized from community write-ups and the lesson author’s experience with multi-agent workflows. The parallel-agent pattern is articulated here (alongside L14’s integration patterns) and is grounded in production multi-agent AI work at Clawless (referenced in L14).

This lesson is original content for the T7 track. Git command syntax is from the public domain Git documentation. The multi-agent fleet pattern (one worktree per agent) is a pattern that has been popularized across the AI-coding community in 2026; this lesson articulates it clearly but does not claim invention.

This lesson is part of the Clawdemy curriculum, licensed under Creative Commons Attribution NonCommercial Share Alike 4.0 International. Pro Git’s CC BY-NC-SA 3.0 license and Clawdemy’s CC BY-NC-SA 4.0 license are directly aligned (the 4.0 license is an approved compatible adaptation license for 3.0 source material per the 3.0 license’s later-versions provision). Commercial use is licensed separately at /legal/licensing.