Overview
Git worktrees allow you to have multiple working directories from a single repository, enabling parallel development workflows with Codex. This is essential for running multiple Codex instances on different tasks simultaneously.
Quick Start
# 1. Create worktree for new feature branch
git worktree add -b feature-api ../project-api main
# 2. Run Codex in worktree
cd ../project-api && Codex "Implement the feature"
cd ../project git merge feature-api git worktree remove ../project-api git branch -d feature-api
## When to Use
- Running multiple Codex agents on different features
- Testing changes while continuing development
- Code review with live comparison
- Parallel bug fixes across branches
- Subagent verification workflows
- A/B implementation comparisons
- CI/CD parallel job execution
## Related Skills
- [repo-sync](../repo-sync/SKILL.md) - Manage multiple repositories
- [sparc-workflow](../sparc-workflow/SKILL.md) - Systematic development process
- [agent-orchestration](../agent-orchestration/SKILL.md) - Multi-agent coordination
---
## Version History
- **1.1.0** (2026-01-02): Added Quick Start, Error Handling table, Metrics, Execution Checklist, Best Practices Do/Don't, updated frontmatter with version/category/related_skills
- **1.0.0** (2025-12-30): Initial release based on Codex best practices
## Sub-Skills
- [Best Practices](best-practices/SKILL.md)
- [Error Handling](error-handling/SKILL.md)
- [Execution Checklist](execution-checklist/SKILL.md)
- [Metrics](metrics/SKILL.md)
## Sub-Skills
- [What is a Worktree?](what-is-a-worktree/SKILL.md)
- [Create a Worktree (+2)](create-a-worktree/SKILL.md)
- [Pattern 1: Feature + Review (+3)](pattern-1-feature-review/SKILL.md)
- [AGENTS.md Configuration](claudemd-configuration/SKILL.md)
- [Headless Mode in Worktrees](headless-mode-in-worktrees/SKILL.md)
- [GitHub Actions Parallel Jobs](github-actions-parallel-jobs/SKILL.md)