Skip to content
binder

Installation

Homebrew (macOS and Linux, the recommended path):

Terminal window
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:

Terminal window
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):

Terminal window
go install github.com/ghchinoy/binder@latest

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

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

From source (local development). Clone the repository and build or run the test suite with Go 1.26.1+:

Terminal window
git clone https://github.com/ghchinoy/binder.git
cd binder
make build   # writes ./bin/binder
make check   # runs gofmt, go vet, actionlint, and go test ./...

A local build reports a Go module pseudo-version or binder/dev rather than a release tag; CONTRIBUTING.md covers what that affects and where to start when changing binder.