Git Worktree Manager for VSCode

English | 简体中文

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

If you enjoy this extension, consider giving it a star ⭐ and sharing it on social platforms like X.com—it really helps!

Why Git Worktree Manager? 🌟

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 "Git 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:

• git-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").

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 📜

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