Git with less typing



You must have a moderately recent copy of Git installed in your PATH to run gg. gg is tested against Git 2.17.1 and newer. Older versions may work, but are not supported.


The latest release is 1.0.3, which was released on . Pre-built binaries are available for Linux, Windows, and macOS.


Binary packages are available for Debian-based systems, including Ubuntu. To use the APT repository, run:

# Import the gg public key
curl -fsSL | sudo apt-key --keyring /etc/apt/trusted.gpg.d/gg.gpg add -

# Add the gg APT repository to the list of sources
echo "deb [signed-by=/etc/apt/trusted.gpg.d/gg.gpg] gg main" | sudo tee /etc/apt/sources.list.d/gg.list
echo "deb-src [signed-by=/etc/apt/trusted.gpg.d/gg.gpg] gg main" | sudo tee -a /etc/apt/sources.list.d/gg.list

# Update the package list and install gg
sudo apt-get update && sudo apt-get install gg

For other distributions, download the Linux binary in the latest GitHub release and place it in your PATH.


Download and run the .msi installer file from the latest GitHub release. Package manager integration is coming soon.


gg can be installed from Homebrew:

brew install gg-scm/gg/gg

or a binary can be downloaded from the latest GitHub release and placed in your PATH.


If you are using an operating system that Go and Git support but there isn’t a gg binary available, you can try building from source.

What’s Next?

After installing gg, the Working Locally guide will show you how to use the basic commands.