Installation¶

macOS and Linux:

brew install blackpaw-studio/tap/leo

Upgrade:

brew upgrade blackpaw-studio/tap/leo && leo service restart

leo update detects the Homebrew install and prints these commands instead of trying to replace the Homebrew-managed binary.

Short-URL installer served from leo.blackpaw.studio (redirects to the version-pinned script in the latest release):

curl -fsSL leo.blackpaw.studio/install | sh

The installer downloads the release tarball for your platform, fetches the release checksums.txt, and verifies the SHA-256 hash before installing. If cosign is present on your PATH it also verifies the Sigstore keyless signature on checksums.txt against the GitHub OIDC issuer and the release tag.

Options:

# Custom install directory
INSTALL_DIR=~/.local/bin curl -fsSL leo.blackpaw.studio/install | sh

# Pin a specific version
VERSION=v0.3.2 curl -fsSL leo.blackpaw.studio/install | sh

Upgrade: leo update replaces the binary in place after the same checksum + cosign verification.

Requires Go 1.25+:

go install github.com/blackpaw-studio/leo/cmd/leo@latest

The binary is installed to $GOPATH/bin (or $HOME/go/bin by default). Make sure this directory is in your PATH.

git clone https://github.com/blackpaw-studio/leo.git
cd leo
make install

This builds with version info from git tags and installs to $GOPATH/bin.

Download the archive for your platform from the Releases page, extract it, and move the leo binary to a directory in your PATH. Verify the archive against checksums.txt from the same release before running it.