Managing Git Worktrees
Git worktrees let you check out multiple branches of the same repository simultaneously into distinct directories on disk. This enables you to switch context instantly, run multiple build or test configurations in parallel, and work with autonomous AI coding agents without git stash conflicts or branch thrashing.
WorktreeWise provides an end-to-end interface to inspect, create, configure, and maintain your worktrees with complete safety guarantees.
Worktree Lifecycle & Operations
Monitor repository health, 6 key metric cards, clean/dirty worktree charts, 4-way disk usage breakdowns, and upstream divergence tracking.
Worktree OverviewCreate worktrees from HEAD, local/remote branches, or tags with sparse checkouts, node_modules symlinking, and environment isolation.
Create WorktreesBrowse all active linked worktrees, copy paths, open in terminal or IDEs, and monitor real-time AI agent status badges.
List & ExploreProtect worktrees stored on external or network drives and safeguard critical branches from accidental deletion or automated pruning.
Lock & UnlockSafely delete worktrees with uncommitted change warnings, force protections, and the option to keep or delete associated Git branches.
Delete WorktreesSafely inspect and prune detached, missing, or corrupt worktrees with WorktreeWise’s review-first confirmation workflow.
Prune Stale WorktreesLifecycle Guide Matrix
| Operation | Purpose | Key WorktreeWise Capabilities | Shortcut |
|---|---|---|---|
| Overview | Repository health dashboard | 6 metric cards, donut status chart, sortable table, 4-way disk space breakdown, and large untracked file detection. | Shift + W |
| Create | Spin up a new workspace | 3 checkout modes (HEAD, Branch, Tag), Pre/Post hooks, Sparse Checkout directory reduction, node_modules symlinking, and multi-source .env isolation. | Shift + W |
| List | Browse worktrees | Quick action menus, direct launch in VS Code/Cursor/JetBrains, terminal pane integration, and active AI agent indicators. | Shift + W |
| Rename | Rename worktree & branch | Renames the directory and executes atomic git branch -m to keep branch and folder naming synchronized. | — |
| Move | Relocate directory | Updates administrative gitdir pointers automatically without corrupting Git internal references. | — |
| Lock | Protect worktree | Prevents accidental deletion, renaming, moving, or automated pruning with custom administrative reasons. | — |
| Unlock | Re-enable operations | Restores full edit and deletion capabilities once external drives reconnect or work completes. | — |
| Delete | Tear down worktree | Uncommitted change detection, dirty state warnings, and options to delete only worktree or delete worktree + branch. | — |
| Prune | Clean stale references | Non-destructive dry-run preview, granular checkboxes, and safety checks before cleaning administrative records. | Shift + P |