Install

Same binary. Nine ways to install it.

Whichever package manager your team already uses, gity is probably there. All distributions ship the same single ~12 MB binary, signed with OIDC-based trusted publishing.

One command to install. One to register.

Pick your package manager.

gity ships everywhere your team already installs things. The same single binary, regardless of how you get it.

cargo install gity

Requires a Rust toolchain. Add --features tray for the system tray UI.

Then:

$ gity register ~/work/monorepo
$ cd ~/work/monorepo
$ git status   # now returns in milliseconds

See all install methods →

All install methods

Pick whichever fits your workflow. Setup is identical from there: gity register <path>.

macOS

Cargo ↗
```
cargo install gity
```
The fastest path if you already have a Rust toolchain. Add --features tray for the system tray UI.
Homebrew ↗
```
brew install neul-labs/tap/gity
```
macOS and Linuxbrew. Auto-updates via `brew upgrade`.
npm / npx ↗
```
npm install -g gity-cli
```
Wrapped distribution for Node-heavy teams. Also runnable as `npx gity-cli register <path>`.
pip ↗
```
pip install gity-cli
```
Wrapped distribution for Python teams. Same binary, friendlier `pip install`.
macOS .pkg ↗
```
Download from GitHub releases
```
Notarised installer for macOS. Easiest path if you don't have Homebrew.

Linux

Cargo ↗
```
cargo install gity
```
The fastest path if you already have a Rust toolchain. Add --features tray for the system tray UI.
Homebrew ↗
```
brew install neul-labs/tap/gity
```
macOS and Linuxbrew. Auto-updates via `brew upgrade`.
npm / npx ↗
```
npm install -g gity-cli
```
Wrapped distribution for Node-heavy teams. Also runnable as `npx gity-cli register <path>`.
pip ↗
```
pip install gity-cli
```
Wrapped distribution for Python teams. Same binary, friendlier `pip install`.

Debian / Ubuntu (.deb) ↗

curl -L https://github.com/neul-labs/gity/releases/latest/download/gity_amd64.deb -o gity.deb && sudo dpkg -i gity.deb

Pre-built .deb for Debian, Ubuntu, and downstream distros.

Snap ↗
```
snap install gity
```
Containerised install for Ubuntu and other snap-compatible distros.

Windows

Cargo ↗
```
cargo install gity
```
The fastest path if you already have a Rust toolchain. Add --features tray for the system tray UI.
npm / npx ↗
```
npm install -g gity-cli
```
Wrapped distribution for Node-heavy teams. Also runnable as `npx gity-cli register <path>`.
pip ↗
```
pip install gity-cli
```
Wrapped distribution for Python teams. Same binary, friendlier `pip install`.
Windows MSI ↗
```
Download gity-x86_64-pc-windows-msvc.msi
```
Code-signed installer for Windows. Adds gity to PATH automatically.
Chocolatey ↗
```
choco install gity
```
Windows package manager for IT-managed environments.

Verify what you installed

Every release ships with SLSA-style attestations. Verify that the binary you downloaded was built by our GitHub Actions workflow and not tampered with downstream:

gh attestation verify gity-0.1.2-x86_64-unknown-linux-gnu.tar.gz --owner neul-labs

Required: GitHub CLI. See GitHub Releases for the full provenance details.

First-run checklist

Register your repo.
```
gity register ~/work/monorepo
```
One-time. Sets up the fsmonitor hook and schedules background prefetch + maintenance.
Enable the bundled Git large-repo flags.
```
git config feature.manyFiles true
```
Stacks with gity for an extra ~30% on cold starts.
Run a quick demo.
```
gity demo
```
Races vanilla Git against gity in a TUI and prints the speedup on your machine, your repo.
Check health.
```
gity health ~/work/monorepo
```
Confirms the watcher is attached and the scheduler is happy.

Need anything else?

The docs cover the rest.

Every CLI subcommand, every flag, the IPC protocol, and the architecture. Or just open a GitHub issue — fastest path to a real answer.

Read the docs → Open an issue