worktree

You can switch git worktrees by name, which identifies the target and moves your working directory there. The active worktree path is persisted to a local state file for quick restoration during future sessions.

Git worktree branch management is used for working on multiple features in isolated directories simultaneously. It prevents branch switching overhead by maintaining separate working trees for each branch, allowing safe transitions between independent development tasks.

To create a git worktree, provide a name and the target branch. The system sets up an isolated working directory linked to that branch and switches you to it, persisting the active state locally for future retrieval.

Yes, the active git worktree path is persisted to a local state file at ~/.claude/state/active-worktree. This allows deterministic restoration of your working environment when you return to the project later.

Git worktree automation is specifically designed for workflows with multiple features or branches requiring isolated worktrees. It implements deterministic steps to ensure safe transitions and state persistence across complex development environments.

The best way to return to the main branch from a git worktree is by requesting a return to main, which cleans up the persisted active state. This safely transitions you back while maintaining the worktree structure for future use.