Codex Worktrees
# Codex Worktrees Usage
Worktrees allow you to create multiple working directories in a Git repository, enabling you to work on different tasks in parallel without interference.
* * *
## What is Worktree?
Git Worktree is a Git feature that allows you to create multiple working directories in the same repository. Codex provides native support for Worktree.
### Use Cases
* Parallel development of multiple features
* Keeping the main branch clean
* Simultaneous development and code review
!(#)
> Worktree lets you work simultaneously as if you had multiple computers.
* * *
## Using Worktree in Codex
### Creating a Worktree
## Creating Worktree
# Creating Worktree in Codex App
# 1. Select project
# 2. Click "New" -> "Worktree"
# 3. Enter branch name
# 4. Click Create
### Running Tasks in Worktree
Select Worktree mode when creating a thread:
| Mode | Description |
| --- | --- |
| **Local** | Work in current project directory |
| **Worktree** | Work in isolated Git worktree |
> Worktree mode creates a new Git worktree, keeping changes isolated.
* * *
### Worktree Management
## Managing Worktrees
# View worktree list
git worktree list
# Create new worktree
git worktree add ../feature-branch -b feature-branch
# Remove worktree
git worktree remove ../feature-branch
* * *
## Best Practices
* Create independent Worktrees for each feature or fix
* Use descriptive branch names
* Clean up unnecessary Worktrees promptly when finished
> Worktree is a powerful tool for parallel development, especially suitable for large projects.
YouTip