https://github.com/jackiotyu/git-worktree-manager

Effortlessly manage Git worktrees in Visual Studio Code! 🚀
https://github.com/jackiotyu/git-worktree-manager

cursor git-worktree trae vscode vscode-extension

Last synced: 18 days ago
JSON representation

Effortlessly manage Git worktrees in Visual Studio Code! 🚀

• Host: GitHub
• URL: https://github.com/jackiotyu/git-worktree-manager
• Owner: jackiotyu
• License: mit
• Created: 2023-08-23T05:39:25.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2026-01-20T01:42:46.000Z (25 days ago)
• Last Synced: 2026-01-20T08:59:31.286Z (25 days ago)
• Topics: cursor, git-worktree, trae, vscode, vscode-extension
• Language: TypeScript
• Homepage: https://marketplace.visualstudio.com/items?itemName=jackiotyu.git-worktree-manager
• Size: 10.3 MB
• Stars: 193
• Watchers: 3
• Forks: 10
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE
  • Agents: AGENTS.md

Awesome Lists containing this project

README

          

# Git Worktree Manager

[![Visual Studio Marketplace Installs](https://img.shields.io/visual-studio-marketplace/i/jackiotyu.git-worktree-manager)](https://marketplace.visualstudio.com/items?itemName=jackiotyu.git-worktree-manager)

[![Open VSX Downloads](https://shields.io/open-vsx/dt/jackiotyu/git-worktree-manager)](https://open-vsx.org/extension/jackiotyu/git-worktree-manager)

[![GitHub release](https://img.shields.io/github/v/release/jackiotyu/git-worktree-manager)](https://github.com/jackiotyu/git-worktree-manager/releases)

[![GitHub Open Issues](https://img.shields.io/github/issues/jackiotyu/git-worktree-manager)](https://github.com/jackiotyu/git-worktree-manager/issues)

[![License](https://img.shields.io/github/license/jackiotyu/git-worktree-manager)](https://github.com/jackiotyu/git-worktree-manager/blob/main/LICENSE)

[![GitHub Stars](https://img.shields.io/github/stars/jackiotyu/git-worktree-manager)](https://github.com/jackiotyu/git-worktree-manager)

English | [简体中文](./README.zh-CN.md)

**Manage Git worktrees safely and efficiently inside Visual Studio Code.**  

Create, switch, and clean up worktrees without losing track of your branches.



## Support 💖

If you enjoy this extension, consider giving it a [star ⭐](https://github.com/jackiotyu/git-worktree-manager) and sharing it on social platforms like [X.com](https://x.com/intent/post?text=Check%20out%20this%20awesome%20VSCode%20extension%20for%20managing%20Git%20worktrees!!%20https%3A%2F%2Fgithub.com%2Fjackiotyu%2Fgit-worktree-manager)—it really helps!

  

    

      


      PayPal

    

    

      


      微信

    

  

## Why Git Worktree Manager? 🌟

Git worktrees make parallel development cleaner by isolating branches into separate directories,  

but managing them manually can be tedious and error-prone.

Git Worktree Manager brings worktree management into VS Code,  

helping you create, switch, and clean up worktrees safely while keeping your repository organized.

> [Manage multiple repositories effortlessly within VSCode.](./images/manage-multiple-repositories.mp4)

### Key Features 🎯

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

   

  > [Switch branches seamlessly with a single command.](https://cdn.jsdelivr.net/gh/jackiotyu/git-worktree-manager@0.4.6/images/switch-branch.mp4) 

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

   

  > [Create a new worktree in seconds.](https://cdn.jsdelivr.net/gh/jackiotyu/git-worktree-manager@0.4.6/images/create-worktree.mp4) 

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

   

  > [Add worktrees to your workspace with a click.](https://cdn.jsdelivr.net/gh/jackiotyu/git-worktree-manager@0.4.6/images/add-worktrees-to-workspace.mp4) 

- **Favorites Management**: Save frequently used worktrees for quick access. 

   

  > [Drop worktrees to favorites for instant access.](https://cdn.jsdelivr.net/gh/jackiotyu/git-worktree-manager@0.4.6/images/drop-to-favorites.mp4) 

- **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. **Requirements**

   - git version >= 2.40

1. **Install the Extension**:

   - Download from the [Visual Studio Marketplace](https://marketplace.visualstudio.com/items?itemName=jackiotyu.git-worktree-manager) or [Open VSX Registry](https://open-vsx.org/extension/jackiotyu/git-worktree-manager).

   - Or search for "Git Worktree Manager" in VSCode’s Extensions view and install.

1. **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.

1. **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 Git Worktree Manager to fit your workflow:

- **`git-worktree-manager.treeView.toSCM`**  

  Display worktrees in the Source Control view.

- **`git-worktree-manager.worktreeCopyPatterns`**  

  Specify files or directories to be copied into a newly created worktree  

  (for example, local config files or environment-specific assets).  

  **Example:** `[".env.local", "config/*.json"]`

- **`git-worktree-manager.worktreeCopyIgnores`**  

  Exclude specific files or paths from being copied when creating a worktree,  

  even if they match `worktreeCopyPatterns`.  

  **Example:** `["node_modules/**", "dist/**"]`

- **`git-worktree-manager.postCreateCmd`**  

  Run a command automatically after a worktree is created  

  (for example, installing dependencies or running setup scripts).  

  **Example:** `"pnpm install"` or `"echo 'Worktree ready'"`

- **`terminal.external.windowsExec`**  

  Set the external terminal on Windows  

  (e.g. `"C:\\Program Files\\Git\\bin\\bash.exe"` for Git Bash).

- **`terminal.external.osxExec`**  

  Set the external 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](https://github.com/jackiotyu/git-worktree-manager/issues).

## License 📜

Distributed under the [MIT License](LICENSE). Use, modify, and share freely!