Verition Worktree Manager for VS Code

A fork of jackiotyu/git-worktree-manager,
enhanced with openSubpath support — allowing you to automatically open a specific subfolder inside each worktree.

English | 简体中文

Effortlessly manage Git worktrees in Visual Studio Code! 🚀 Simplify your workflow, work on multiple branches simultaneously, and boost productivity with this powerful extension.

Why Git Worktree Manager? - From jackiotyu 🌟

Tired of juggling branches, stashing changes, or resolving merge conflicts? Git Worktree Manager makes parallel development a breeze by leveraging Git worktrees, letting you work on multiple branches in separate directories without leaving VSCode. Whether you’re tackling hotfixes, experimenting with features, or managing complex projects, this extension saves time, reduces friction, and keeps your workspace organized. With seamless integration and intuitive controls, it’s the ultimate tool for developers who want a smoother Git experience.

Manage multiple repositories effortlessly within VSCode.

Key Features 🎯

• Quick Worktree Switching: Switch between worktrees using Ctrl+Shift+R or the Source Control view.

  Switch branches seamlessly with a single command.

• Effortless Worktree Creation: Create new worktrees without touching the command line.

  Create a new worktree in seconds.

• Workspace Integration: Add worktrees to your VSCode workspace for easy access.

  Add worktrees to your workspace with a click.

• Favorites Management: Save frequently used worktrees for quick access.

  Drop worktrees to favorites for instant access.

• Copy Untracked Files: Automatically include untracked files when creating a new worktree.
• Multi-Language Support: Available in English, Simplified Chinese, Traditional Chinese and Japanese.
• Customizable Terminal: Use your preferred terminal (e.g., iTerm on macOS, Git Bash on Windows).

Getting Started 🚀

1. Install the Extension:

   • Download from the Visual Studio Marketplace.
   • Or search for "Verition Worktree Manager" in VSCode’s Extensions view and install.

2. Quick Start:

   • Open VSCode in a Git repository.
   • Press Ctrl+Shift+R to launch the worktree manager.
   • Create, switch, or delete worktrees using the intuitive interface.

3. Example Workflow:

   • Create a new worktree: Select “Create Worktree” and specify a branch.
   • Switch to it instantly via the Source Control view or command palette.
   • Add it to your VSCode workspace to work on multiple branches side by side.
   • Save it to favorites for quick access in the future.

Configuration ⚙️

Customize your experience:

• verition-worktree-manager.treeView.toSCM: Display worktrees in the Source Control view.
• terminal.external.windowsExec: Set your preferred terminal (e.g., "C:\\Program Files\\Git\\bin\\bash.exe" for Git Bash).
• terminal.external.osxExec: Use iTerm or another terminal on macOS (e.g., "iTerm.app").

New Feature: openSubpath

You can tell the extension to open a specific subfolder inside each worktree.
Add to your settings.json:

{
  "verition-worktree-manager.openSubpath": "analytics",
}

Contributing 🤝

We love contributions! Here’s how to get involved:

1. Fork the repository.
2. Create a feature branch (git checkout -b feature/awesome-idea).
3. Commit your changes (git commit -m "Add awesome idea").
4. Push to the branch (git push origin feature/awesome-idea).
5. Open a Pull Request.

Have ideas? Open an issue with the "enhancement" tag or explore open issues.

License 📜

This project is based on jackiotyu/git-worktree-manager (MIT License).
Additional modifications © 2025 Verition Fund and contributors.

Distributed under the MIT License. Use, modify, and share freely!