What problem does it solve?
This Skill provides clear, safe, and platform-aware guidance for setting up isolated Git worktrees, ensuring users understand the implications for branch management, synchronization, and cleanup across different development environments like Codex and Claude.
Core Features & Use Cases
- Platform-Specific Guidance: Tailors instructions for Codex app threads and Claude CLI sessions.
- Safe Synchronization: Explains the difference between 'Apply' and 'Overwrite' when syncing worktree changes back to a local checkout, preventing accidental data loss.
- Branch Management: Warns about and guides users through the constraint that a single branch cannot be checked out in multiple worktrees simultaneously.
- Cleanup Strategy: Recommends safe cleanup procedures for worktrees to avoid data loss.
- Use Case: A developer needs to work on a new feature without disrupting their main branch. They can use this skill to create an isolated worktree, perform their work, and then safely sync their changes back, all while understanding the potential pitfalls.
Quick Start
Use the using-git-worktrees skill to start a new worktree for a feature branch in Codex.