Diagnose and recover
Git Worktree Troubleshooting: Common Errors and Fixes
Diagnose broken paths, locked worktrees, stale metadata, detached HEAD states, pruning surprises, and branch checkout conflicts.
Explore Troubleshooting
git worktree branch already checked out
Branch already checked out
Learn the practical workflow, common pitfalls, and the safest way to handle this Git worktree scenario.
Read guide →git worktree remove not working
Worktree cannot be removed
Learn the practical workflow, common pitfalls, and the safest way to handle this Git worktree scenario.
Read guide →git worktree not a git repository
Worktree is not a Git repository
Learn the practical workflow, common pitfalls, and the safest way to handle this Git worktree scenario.
Read guide →git worktree missing directory
Missing worktree directory
Learn the practical workflow, common pitfalls, and the safest way to handle this Git worktree scenario.
Read guide →git worktree invalid path
Worktree path is invalid
Learn the practical workflow, common pitfalls, and the safest way to handle this Git worktree scenario.
Read guide →stale git worktree
Worktree is stale
Learn the practical workflow, common pitfalls, and the safest way to handle this Git worktree scenario.
Read guide →git worktree pruneable
Worktree is pruneable
Learn the practical workflow, common pitfalls, and the safest way to handle this Git worktree scenario.
Read guide →moved git worktree
Worktree was moved manually
Learn the practical workflow, common pitfalls, and the safest way to handle this Git worktree scenario.
Read guide →broken git worktree
Repair a broken worktree
Learn the practical workflow, common pitfalls, and the safest way to handle this Git worktree scenario.
Read guide →branch used by worktree
Cannot delete branch because of worktree
Learn the practical workflow, common pitfalls, and the safest way to handle this Git worktree scenario.
Read guide →git worktree locked
Worktree locked and cannot remove
Learn the practical workflow, common pitfalls, and the safest way to handle this Git worktree scenario.
Read guide →git worktree prune removed worktree
Worktree missing after prune
Learn the practical workflow, common pitfalls, and the safest way to handle this Git worktree scenario.
Read guide →git worktree detached head
Detached HEAD in worktree
Learn the practical workflow, common pitfalls, and the safest way to handle this Git worktree scenario.
Read guide →git worktree corrupted
Worktree metadata corrupted
Learn the practical workflow, common pitfalls, and the safest way to handle this Git worktree scenario.
Read guide →git worktree gitdir wrong path
.git file points to wrong path
Learn the practical workflow, common pitfalls, and the safest way to handle this Git worktree scenario.
Read guide →