Installation

Homebrew (macOS and Linux)

brew install ElOrlis/zurdo/zurdo

This pulls a pre-built binary from the public zurdo-dist releases — no Rust toolchain required. Shipped targets:

• macOS Apple Silicon (aarch64-apple-darwin)
• Linux x86_64 and aarch64, via Homebrew on Linux

Intel macOS is not pre-built yet.

Upgrading from a pre-1.0 install? Older versions were tapped against the source repo, which is now private and no longer carries the formula. Re-tap once against the public tap:

brew untap elorlis/zurdo
brew install ElOrlis/zurdo/zurdo

From a release tarball

# Replace VERSION and TARGET to taste. Available targets:
#   aarch64-apple-darwin
#   x86_64-unknown-linux-gnu · aarch64-unknown-linux-gnu
VERSION=1.7.0
TARGET=aarch64-apple-darwin
curl -fsSL "https://github.com/ElOrlis/zurdo-dist/releases/download/v${VERSION}/zurdo-v${VERSION}-${TARGET}.tar.gz" \
  | tar -xz -C /usr/local/bin zurdo

Each release also ships a checksums.txt and per-file .sha256 siblings — verify before installing in CI:

curl -fsSLO "https://github.com/ElOrlis/zurdo-dist/releases/download/v${VERSION}/checksums.txt"
sha256sum --check --ignore-missing checksums.txt

Shell completions and man pages

Since v1.7.0, Homebrew installs bash, zsh, and fish completions plus man pages (man zurdo, man zurdo-run, …) automatically. Release tarballs bundle the same files under completions/ and man/ — copy them wherever your shell and manpath look.

No packaged files needed, though: the binary generates its own completions for bash, zsh, fish, elvish, and powershell, always matching the installed version:

eval "$(zurdo completions zsh)"     # e.g. in your ~/.zshrc

Source availability

Zurdo is proprietary, closed-source software. The source is not publicly available; install the pre-built binaries via Homebrew or the release tarballs above.

Prerequisites: an agent CLI

Zurdo shells out to an agent CLI for the executor role. Install and authenticate at least one:

zurdo init writes a .zurdo/config.toml with all three providers wired; switching is a one-line edit. See Providers for how zurdo drives each CLI.

Verify the installation

zurdo --version

Next: Usage