Installation

rusty ships as a single Zig-built binary. There is no macOS or Windows build.

Requirements

• Linux (x86_64 or aarch64)
• Zig — to compile from source
• git — for workspace affected analysis and crate sources
• A network connection for toolchain and registry fetches

Build from source

Clone the repository and build a release binary:

git clone https://github.com/iresolvedllc/rusty.git
cd rusty
zig build -Doptimize=ReleaseSafe

The binary lands at zig-out/bin/rusty. Install it somewhere on your PATH, or invoke it directly.

# optional: install to ~/.local/bin
install -m 755 zig-out/bin/rusty ~/.local/bin/rusty

Install a Rust toolchain

rusty manages toolchains the way rustup does — but inverted into the same binary:

rusty env install stable
rusty env use stable
rusty env show

env show bootstraps ~/.rusty/ (store, cache, toolchains, shims) on first run.

Put shims on PATH

After env use, hardlinked shims in $RUSTY_HOME/bin dispatch cargo, rustc, rustdoc, and related tools to the active toolchain:

export PATH="${RUSTY_HOME:-$HOME/.rusty}/bin:$PATH"
cargo --version
rustc -vV

Add that export to your shell profile if you want it permanent.

Verify

rusty --version
rusty env list
rusty store path
rusty cache path

You should see version 0.0.1-dev, your installed toolchain, and paths under ~/.rusty/ (unless RUSTY_HOME overrides the data root).

Next steps

• Your first project — scaffold, fetch, build, test
• Migrate from Cargo — convert an existing workspace