Skip to content


Package Control

It is highly recommended to install GitGutter with Package Control as it automatically installs required dependencies and keeps all packages up to date.

  1. Install Package Control if you haven't yet.
  2. Open Command Palette (Ctrl + Shift + P for Windows/Linux, Cmd + Shift + P for Mac OS)
  3. Search for Package Control: Install Package and hit Enter.
  4. Type GitGutter and press Enter to install it.


If you are interested in testing bleeding edge features you can set up Package Control to install pre-releases by adding GitGutter to install_prereleases key in the Package Control.sublime-settings.



The GitGutter-Edge package is replaced by Pre-Releases.

This change was made …

  1. to avoid issues with functions which depend on the package name.
  2. because branch based packages are deprecated by Package Control.
  3. to have more control about when to publish new features for testing.


If you don't want to wait for Pre-Releases you can pull from master branch directly.

Manual Installation

You can clone this repository into your Sublime Text x/Packages

Mac OS
cd ~/Library/Application\ Support/Sublime\ Text\ 3/Packages/
git clone git://
cd ~/.config/sublime-text-3/Packages
git clone git://
cd "%APPDATA%\Sublime Text 3\Packages"
git clone git://


The git command must be available on the command line.

You may need to add the directory containing git.exe to your PATH environment variable.


Some functions of GitGutter depend on the following external libraries to work properly. They are installed automatically for you by Package Control, so normally don't need to care about. But on setups without Package Control you need to make sure they are installed and available in the global namespace of Sublime Text's python interpreter on your own.

Mac OS

On Mac OS you might need to install the package SublimeFixMacPath if you are using Sublime Text 2 or one of the early Sublime Text 3 dev builds.

Manual Install

To manually install pull from the linked repos into ST's Packages folder.