Installation

README.md, lines 1573–1643View source

Pick your OS below. Each has one copy-paste command.

Windows#

bash

choco install zirv

macOS#

bash

brew tap glubiz/homebrew-tap
brew install zirv

If Homebrew reports the tap as untrusted, run brew trust glubiz/tap and retry.

The published binary is universal (Intel and Apple Silicon), so this works on either Mac.

Linux & macOS#

Recommended — install script (works on both Linux x86_64 and macOS Intel/Apple Silicon):

bash

curl -sSfL https://raw.githubusercontent.com/Glubiz/zirv-cli/main/install.sh | sh

To install a specific version:

bash

curl -sSfL https://raw.githubusercontent.com/Glubiz/zirv-cli/main/install.sh | sh -s -- <version>

Package Manager Detection#

If the script detects a Homebrew-managed zirv installation, it refuses to overwrite it by default with a message recommending brew upgrade zirv instead. To override this safety check and force an installation (not recommended), set ZIRV_INSTALL_FORCE=1:

bash

ZIRV_INSTALL_FORCE=1 curl -sSfL https://raw.githubusercontent.com/Glubiz/zirv-cli/main/install.sh | sh

PATH Shadowing Warning#

After a successful install, the script checks whether the just-installed binary is the one found on your $PATH. If not—for example, because /opt/homebrew/bin appears before /usr/local/bin on Apple Silicon—it warns you to ensure the install directory comes first in your PATH.

Alternative — Homebrew on Linux, via the same tap:

bash

brew tap glubiz/homebrew-tap
brew install zirv

If Homebrew reports the tap as untrusted, run brew trust glubiz/tap and retry.

The prebuilt Linux release is x86_64-only. On other architectures (aarch64, armv7, ...) the install script fails fast with a pointer to the source build; the Homebrew formula does not guard the architecture, so skip it there and build from source instead (see below). Releases up to 2.39.0 additionally require glibc 2.39+; from 2.39.1 the Linux binary is fully static.

From source (any platform/arch)#

bash

cargo install --git https://github.com/Glubiz/zirv-cli

Works today without a crates.io publish, and is the only supported path on architectures the release pipeline doesn't build for (e.g. Linux aarch64).

Precompiled Binaries#

Download the latest release from the [GitHub Releases]: https://github.com/Glubiz/zirv-cli/releases

Assets per version: zirv-<version>-linux.tar.gz (x86_64), zirv-<version>-macos.tar.gz (universal x86_64+arm64), zirv-<version>-windows.exe.