Git worktrees let one repository have multiple working directories checked out at different branches. They are useful with agents because agents produce file changes, and file changes need isolation.
Why Worktrees Help
Use worktrees when:
- You want to run two agent experiments in parallel.
- A cloud or command line agent should not touch your main working tree.
- You need a clean branch for review while local work continues elsewhere.
- You want to compare two implementation paths without stashing.
Basic Commands
git worktree add ../project-feature feature/agent-experiment
git worktree list
git worktree remove ../project-featureRun the agent from inside the worktree:
cd ../project-feature
claudeor:
agentReview Discipline
A worktree isolates files. It does not prove correctness. Before merging work from any agent-created branch:
git status --short
git diff
bun run lint
bun run test:unitUse worktrees to make parallel work reviewable, not to avoid review.