Install yqr

3 min read

Install

Every path below ends with a yqr binary on your PATH. Pick the one that matches how you manage tools; they all install the same program.

Homebrew

$ brew install zoosky/tap/yqr

Installs the prebuilt binary — Apple Silicon and Intel Macs, and x86_64 Linux. The release pipeline pushes each version’s formula to the tap, so brew upgrade tracks new releases.

Shell installer

$ curl --proto '=https' --tlsv1.2 -LsSf https://github.com/zoosky/yqr/releases/latest/download/yqr-installer.sh | sh

Detects your platform, downloads the matching archive from the latest GitHub release, and installs the binary into $CARGO_HOME/bin (~/.cargo/bin by default) — no Rust toolchain involved. Prefer not to pipe a script into sh? The next section is the same download done by hand.

Prebuilt archive

Each GitHub release attaches an archive per platform, with a SHA-256 checksum beside it:

ArchivePlatform
yqr-aarch64-apple-darwin.tar.xzmacOS, Apple Silicon
yqr-x86_64-apple-darwin.tar.xzmacOS, Intel
yqr-x86_64-unknown-linux-musl.tar.xzLinux x86_64 — static musl build, runs on any distribution

Download, verify, unpack:

$ curl -sLO https://github.com/zoosky/yqr/releases/latest/download/yqr-aarch64-apple-darwin.tar.xz
$ curl -sLO https://github.com/zoosky/yqr/releases/latest/download/yqr-aarch64-apple-darwin.tar.xz.sha256
$ shasum -a 256 -c yqr-aarch64-apple-darwin.tar.xz.sha256
yqr-aarch64-apple-darwin.tar.xz: OK
shasum: WARNING: 1 line is improperly formatted
$ tar xf yqr-aarch64-apple-darwin.tar.xz

OK is the verdict; the warning is shasum objecting to the checksum file’s trailing blank line and does not affect it. The archive holds the yqr binary alongside the licenses, README, and changelog — copy the binary anywhere on your PATH.

cargo install

$ cargo install yqr

Builds the published crate from source with your own toolchain (Rust 1.99 or later) and installs it to ~/.cargo/bin/yqr. Using yqr as a Rust library rather than a binary? Depend on the crate instead — the home page shows the default-features = false form that leaves the CLI layer out, and docs.rs/yqr documents the API.

From a source checkout

$ git clone https://github.com/zoosky/yqr
$ cd yqr
$ cargo build --release

The binary lands at target/release/yqr; cargo install --path . puts it on your PATH instead.

Confirm it works

$ yqr --version
yqr 0.12.0 (b484fc9, built 2026-11-07 10:30:44 UTC)
target: aarch64-apple-darwin
$ echo 'a: 1' | yqr '.a'
1

The version line names the release, the exact commit it was built from, and the target — worth pasting into a bug report.

No install at all

The playground runs the same engine in your browser, compiled to WebAssembly: paste YAML, run filters, and watch the byte-for-byte guarantee hold, without touching your machine. Embedding that engine in your own page is the playground’s closing note — every release attaches the built wasm package as yqr-wasm-pkg.tar.gz.