Git WorkTree

Git Worktree Extension for Visual Studio

A lightweight extension to easily manage Git worktrees inside Visual Studio. Create, switch, and work on multiple branches without leaving your IDE.

Why this extension?

Visual Studio’s Git support doesn’t handle multi-branch workflows well. This extension fixes that.

• No need for a separate Git client just to manage worktrees (Visual Studio already handles most Git features).
• Other extensions (like Git Extensions) require installing their own Git client this doesn’t.
• You don’t even need Git installed on your PC this uses Visual Studio’s inbuilt Git.

What it does:

• Create new worktrees for any branch
• Switch between worktrees smoothly
• Manage multiple branches side-by-side

Usage:

Open a solution or folder with a Git repository. Note: this extension only works if there’s an active Git repo or solution open otherwise, it won’t show up.

After installation, two options appear under Git > Git Worktree:

• Create Worktree (Ctrl+Shift+=)
• Manage Worktrees (Ctrl+Shift+\\)

Create Worktree Window:

1. Shows current repo

2. Choose branch from the dropdown

   • You can also type to filter it will suggest relevant matches
   • It lists all branches in the repo
   • Branches with a "+" prefix already have a worktree

3. Set path for the new worktree

   • By default, the path will be: repo path/repo_name_worktree/branch_name
   • Worktree name = branch name
   • You can choose your own directory
   • You can also set a default base directory in Settings (explained later)

4. Force create: overwrites existing/overlapping worktrees

5. Option to open the new worktree in a new Visual Studio window (only works if “Load” is enabled in settings)

6. Creates the worktree for the selected branch at the selected path

Manage Worktrees Window:

1. Shows current repo

2. Lists all created worktrees (with their paths)

3. Option to open the selected worktree in a new VS window

4. Open selected worktree

5. Force remove (even if there are uncommitted changes)

6. Prune dangling worktree references

   • Sometimes when you delete a worktree manually, Git still holds a reference
   • Pruning removes that, so Git allows creating worktree again for that branch

7. Remove selected worktree

Output Window:

All Git command executions performed by the extension are logged in Visual Studio’s Output pane (under Git Worktree), and key status updates also appear in the status bar at the bottom for quick feedback.

Settings:

Accessible via Git > Settings > Source Control > Git Worktree

• Default Worktree Directory:

  • If empty, defaults to: repo directory\repo_name_worktree\branch_name
  • Otherwise, uses your custom directory

• Load:

  • If True: opens new worktree in a new window after creation
  • If False: it just creates the worktree but doesn’t open it Useful if you want to prepare worktrees but open them later

This keeps your multi-branch Git workflow clean and fully integrated without leaving Visual Studio.