Git Toggle
Quickly enable or disable Git integration in your VS Code workspace.
Git Toggle provides a dedicated Activity Bar interface for managing Git integration directly from Visual Studio Code. Toggle Git on or off with a single click, monitor its current status, and restore your inherited Git configuration whenever you re-enable it.
Features
- One-Click Toggle — Enable or disable Git integration without opening Settings.
- Dedicated Activity Bar View — Manage Git from a convenient, purpose-built interface.
- Live Status Updates — See whether Git integration is enabled or disabled.
- Automatic Synchronization — Reflects changes to the built-in
git.enabled setting.
- Workspace-Specific Control — Disable Git for the current workspace without changing your global preferences.
- Restore Inherited Settings — Remove the workspace override when enabling Git again, allowing VS Code to use the inherited configuration.
Getting Started
- Install Git Toggle from the Visual Studio Code Marketplace.
- Open a workspace in VS Code.
- Click the Git Toggle icon in the Activity Bar.
- Use the toggle button to enable or disable Git integration.
The interface displays the current Git state and updates automatically when the relevant setting changes.
How It Works
Git Toggle manages VS Code's built-in git.enabled setting at the workspace level.
Disable Git
When Git is enabled, clicking the toggle sets:
{
"git.enabled": false
}
This disables VS Code's built-in Git integration for the current workspace without modifying the global setting.
Enable Git
When Git is disabled, clicking the toggle removes the workspace-level override by resetting git.enabled to its inherited value.
This allows VS Code to use the applicable configuration from the user or other configuration scopes.
Note: Git Toggle controls VS Code's Git integration. It does not uninstall Git, delete repositories, or modify repository history.
Commands
| Command |
Description |
Toggle Git |
Enable or disable Git integration. |
Git Toggle: Close Workspace and Quit |
Close the workspace and quit VS Code. |
Git Toggle: Collapse Workspace outline |
Collapse the workspace's Explorer folders. |
Commands can be accessed through the Command Palette when registered and available in the extension.
Requirements
- Visual Studio Code 1.110.0 or later.
- Git is required for Git repository operations. Git Toggle manages VS Code's Git integration rather than installing Git itself.
Extension Settings
Git Toggle does not introduce additional user-configurable settings.
It manages the built-in VS Code setting:
| Setting |
Description |
git.enabled |
Enables or disables VS Code's Git integration. |
The extension applies changes at the workspace configuration level.
Troubleshooting
Git still appears disabled after enabling it
Check whether git.enabled is disabled in another applicable configuration scope, such as your user settings, and verify that the built-in Git extension is available.
The Git view does not appear
Make sure Git Toggle is installed and enabled, then reload the VS Code window if necessary.
Contributing
Contributions, bug reports, and feature suggestions are welcome.
To contribute:
- Fork the repository.
- Create a feature branch.
- Make your changes and test them.
- Submit a pull request describing your changes.
Please include clear reproduction steps when reporting bugs.
Repository
GitHub — talalalmrka/git-toggle
License
This project is licensed under the MIT License.