Skip to content
Ziv

Installation

ziv ships as a single standalone binary. Download, extract, and run.

1. Download

Section titled “1. Download”

Grab the archive for your platform from the latest GitHub Release:

Platform Archive
macOS (Apple Silicon) ziv-darwin-arm64.tar.gz
macOS (Intel) ziv-darwin-x64.tar.gz
Linux (x86_64) ziv-linux-x64.tar.gz
Linux (arm64) ziv-linux-arm64.tar.gz
Windows (x86_64) ziv-windows-x64.zip
Windows (arm64) ziv-windows-arm64.zip

2. Verify (optional)

Section titled “2. Verify (optional)”

Each archive has a .sha256 sidecar (and a combined SHASUMS):

Terminal window
shasum -a 256 -c ziv-<platform>.tar.gz.sha256   # macOS/Linux
# Windows: Get-FileHash ziv-windows-x64.zip -Algorithm SHA256

3. Extract

Section titled “3. Extract”

macOS / Linux:

Terminal window
tar -xzf ziv-<platform>.tar.gz
cd ziv

Windows: unzip ziv-windows-<arch>.zip and open the ziv folder.

4. Run and log in

Section titled “4. Run and log in”
Terminal window
./ziv --help
./ziv project new my-proofs   # create a project (git + registration + zpi scaffold)

Inside an interactive session (for example ziv open <workspace>), run /login <provider> to authenticate (e.g. /login anthropic), then /model to pick a model.

Next: the quickstart walks the full loop.

Building from source

Section titled “Building from source”

Developers building from the repository:

  • bun is an external build prerequisite (install it separately; it is not an npm dependency).
  • NODE_USE_ENV_PROXY=1 npm run build:binary -w @ziv/cli — one local binary for the current platform.
  • ./scripts/build-ziv-binaries.sh — all six platform archives plus checksums.