Working in Parallel

Use git worktrees to work in parallel when another agent is in the same directory.

Git worktrees let you check out multiple branches into separate directories. Each worktree has its own isolated files while sharing the same Git history and remote connections. Changes in one worktree won't affect others, so parallel agents can't interfere with each other.

Learn more: Git worktree documentation

IMPORTANT: Worktree Location

All worktrees MUST be created under .letta/worktrees/ in the repo root. This keeps worktrees organized, gitignored, and out of the user's project directory.

Before creating the first worktree, ensure .letta/worktrees is in the repo's .gitignore:

# Add to .gitignore if not already present
grep -q '.letta/worktrees' .gitignore 2>/dev/null || echo '.letta/worktrees' >> .gitignore