Skip to content

Installation

git-spice may be installed with a pre-built binary or built from source.

System requirements

  • Operating system: Linux and macOS are fully supported. Windows support was added in v0.6.0.

  • Architecture: x86_64 and aarch64 architectures are supported. Additionally on Linux, some 32-bit ARM architectures are also supported.

  • Git: At least Git 2.38 is required for git-spice to operate correctly. Earlier versions may work, but are not officially supported.

Pre-built binary

To install a pre-built binary, use one of the following methods:

Homebrew/Linuxbrew

git-spice is available in homebrew-core (the default formulae repository for Homebrew and Linuxbrew). Install git-spice with the following command:

brew install git-spice

You can also use my Homebrew Tap to install the latest release:

brew install abhinav/tap/git-spice

Binary installation tools

ubi

ubi is a binary installation tool that is able to download pre-built binaries from GitHub Releases.

If you use ubi, use the following command to install git-spice:

ubi --project abhinav/git-spice --exe gs

mise

mise supports installing tools from various sources, and includes a ubi backend.

If you use mise, use the following command to install git-spice:

mise use --global 'ubi:abhinav/git-spice[exe=gs]'

AUR (ArchLinux)

If you're using ArchLinux, install the 'git-spice-bin' package from the AUR:

git clone https://aur.archlinux.org/git-spice-bin.git
cd git-spice-bin
makepkg -si

# Or, with an AUR helper like yay:
yay -S git-spice-bin

Manual download

You can manually download the latest release of git-spice from the GitHub Releases page.

Build from source

To build from source, follow these steps:

  1. Install the Go compiler.
  2. Run the following command:

    go install go.abhg.dev/gs@latest
    

Next steps