Installation

Homebrew (macOS and Linux, the recommended path):

brew install ghchinoy/tap/binder

ghchinoy/tap is Homebrew’s shorthand for the ghchinoy/homebrew-tap repository, whose Formula/binder.rb is regenerated by GoReleaser on every release. To upgrade later: brew upgrade binder.

Direct download. Grab a prebuilt archive for your platform from the latest release and put the binder binary on your PATH. Every release publishes linux/darwin/windows × amd64/arm64 archives named binder_<version>_<os>_<arch>.tar.gz (.zip on Windows), plus a checksums.txt. The v0.2.1 release, for example, carries:

binder_0.2.1_darwin_amd64.tar.gz  binder_0.2.1_linux_amd64.tar.gz   binder_0.2.1_windows_amd64.zip
binder_0.2.1_darwin_arm64.tar.gz  binder_0.2.1_linux_arm64.tar.gz   binder_0.2.1_windows_arm64.zip
checksums.txt

Note: The v is in the tag but not in the filename.

Set VERSION to the tag on the releases page without its leading v (the snippet puts the v back for the tag path and leaves it off the filename), pick your platform, and the rest is mechanical:

export VERSION=...  OS=darwin  ARCH=arm64   # OS: linux|darwin|windows · ARCH: amd64|arm64
BASE="https://github.com/ghchinoy/binder/releases/download/v${VERSION}"   # tag keeps its "v"
curl -fsSL -O "${BASE}/binder_${VERSION}_${OS}_${ARCH}.tar.gz"
curl -fsSL -O "${BASE}/checksums.txt"
shasum -a 256 --ignore-missing -c checksums.txt   # or: sha256sum --ignore-missing -c checksums.txt
tar -xzf "binder_${VERSION}_${OS}_${ARCH}.tar.gz"
sudo mv binder /usr/local/bin/
binder --version    # binder/<version> — the stamp never carries a leading "v"

Each archive also contains LICENSE and README.md, and nothing else: no docs directory, no sample corpus. Cosign signatures and SBOMs are not published yet, so checksums.txt is the integrity artifact today; see what is deferred, and why.

Go toolchain (requires Go 1.26.1+, the floor declared in go.mod):

go install github.com/ghchinoy/binder@latest

go install stamps the binary cleanly, exactly like Homebrew and the direct download: binder --version prints binder/0.3.0, no leading v.

Winget: not published yet (tracked in #40). Windows users: take the release .zip above.

From source. For anyone who prefers building their own binaries, and the way to run a commit that has not been released yet: clone the repo and run make build with Go 1.26.1+. The resulting binary reports a Go module pseudo-version rather than a release version; CONTRIBUTING.md covers what that affects, and is where to start if you want to change binder rather than just run it.