You must have a moderately recent copy of Git installed in your
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 https://gg-scm.io/apt-key.gpg | 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] https://apt.gg-scm.io gg main" | sudo tee /etc/apt/sources.list.d/gg.list echo "deb-src [signed-by=/etc/apt/trusted.gpg.d/gg.gpg] https://apt.gg-scm.io 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
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
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.
After installing gg, the Working Locally guide will show you how to use the basic commands.