2 releases
| new 0.2.0 | Mar 11, 2026 |
|---|---|
| 0.1.0 |
|
#232 in Caching
53KB
1.5K
SLoC
rvx
Like uvx but for Rust — download and run pre-built crate binaries without a Rust toolchain.
Usage
rvx ripgrep -- --version
rvx bat@0.24.0 -- 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
- Check local cache (
~/.rvx) - Query crates.io for version and binstall metadata
- Resolve binary from binstall template or GitHub releases
- Download, verify SHA256 checksum, extract
- 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
Dependencies
~15–36MB
~531K SLoC