Installing Grit

Time to install Grit. Pick one path — the install script (everyone) or go install (if you have the Go toolchain). Both produce the exact same binary at the same place on your PATH.

Path A — the install script (recommended)

One line. Works on macOS, Linux, and Windows. Detects whether you already have grit and either installs fresh or runs the self-update.

macOS / Linux

$curl -fsSL https://gritframework.dev/install.sh | sh

Windows (PowerShell)

$iwr -useb https://gritframework.dev/install.ps1 | iex

The script does three things: detects your OS + architecture, downloads the matching release binary from GitHub, and puts it on your PATH (/usr/local/bin/grit on Unix, %USERPROFILE%\.grit\bin\grit.exe on Windows). If you already had grit, it runs grit update instead.

Path B — `go install` (if you have Go)

If you already have Go 1.21+ on your machine, this is the most traditional path:

$go install github.com/MUKE-coder/grit/v3/cmd/grit@latest

Compiles grit from source and puts it in $(go env GOPATH)/bin/grit. Make sure that directory is on your PATH — most Go setups add it automatically.

Want a pinned version?

For reproducible installs (CI scripts, team alignment), pin the exact version:

# Pin via the install script
$GRIT_VERSION=v3.25.2 curl -fsSL https://gritframework.dev/install.sh | sh
# Pin via go install
$go install github.com/MUKE-coder/grit/v3/cmd/grit@v3.25.2

What ships with the install

One binary (~20 MB). That's it. No background daemon, no telemetry, no licence server. You can move grit to a USB stick and run it anywhere with the matching OS.

What's next

You have grit on your machine. Next lesson — a 3-minute sanity check — confirms everything's wired right and you know how to update when a new version drops.