rvx

Like uvx but for Rust — download and run pre-built crate binaries without a Rust toolchain.

Usage

rvx ripgrep -- --version
rvx [email protected] -- README.md
rvx --bin parry parry-ai    # when binary name differs from crate

Cache Management

rvx --list              # show cached binaries
rvx --clean             # clear cache
rvx --update ripgrep    # force re-download

Options

Flag	Description
--bin <name>	Binary name if it differs from the crate name
--update	Re-download even if cached
--list	List cached binaries
--clean	Remove all cached binaries
--quiet, -q	Suppress download output

How It Works

1. Check local cache (~/.rvx)
2. Query crates.io for version and binstall metadata
3. Resolve binary from binstall template or GitHub releases
4. Download, verify SHA256 checksum, extract
5. Cache and exec (Unix exec() replaces current process)

Supports .tar.gz, .tar.xz, .tar.zst, and .zip archives.

Install

Linux / macOS:

curl -fsSL https://raw.githubusercontent.com/vaporif/rvx/main/install.sh | sh

Windows (PowerShell) (untested):

irm https://raw.githubusercontent.com/vaporif/rvx/main/install.ps1 | iex

Nix:

nix profile install github:vaporif/rvx

Or run without installing:

nix run github:vaporif/rvx -- ripgrep --version

From source:

cargo install --git https://github.com/vaporif/rvx

Configuration

Environment Variable	Default	Description
GITHUB_TOKEN	—	GitHub API token (avoids rate limits)
RVX_HOME	~/.rvx	Override cache directory

Development

cargo build
cargo test
cargo clippy -- -D warnings
cargo fmt

License

MIT