Skip to content
butverify docs
← butverify.dev

Install the CLI

The CLI is a single Go binary. Pick the install method that matches your machine.

macOS / Linux (Homebrew)

Terminal window
brew install butverify/tap/bv

This installs from our Homebrew tap and verifies the cosign signature on the release binary.

Linux (manual)

Download the latest release from github.com/butverify/cli/releases, extract bv, and move it onto your $PATH:

Terminal window
# Replace VERSION + ARCH with the values from the release page.
curl -fsSL "https://github.com/butverify/cli/releases/download/VERSION/bv_linux_ARCH.tar.gz" \
  | tar -xz
install -m 0755 bv /usr/local/bin/bv

Windows

Download bv_windows_amd64.zip from the same release page, unzip, and add the folder to your PATH. The CLI runs in PowerShell and cmd.exe.

Verify

Terminal window
bv --version

You should see something like bv 0.1.0 (rev abcdef0, signed).

Authenticate

butverify authenticates the CLI with a GitHub App installation token. After installing the GitHub App on your account or organization, the dashboard surfaces an installation token you can hand to the CLI:

Terminal window
# Paste the token when prompted:
bv init --token <token>


# Or pipe it from a script:
echo "$BV_TOKEN" | bv init

bv init calls /v1/auth/whoami, captures your tenant + account, and writes the token to ~/.config/butverify/config.json with mode 0600.

If you haven’t installed the GitHub App yet, visit app.butverify.dev — the dashboard walks you through it.

Next