CLI reference
Complete rusty command reference for 0.0.1-dev.
Invoke rusty with no arguments or rusty --help to print usage. Version: rusty --version.
| Flag | Description |
|---|
-h, --help | Show help |
-V, --version | Print version (0.0.1-dev) |
| Command | Description |
|---|
rusty env install <id> [target...] | Install a toolchain |
rusty env uninstall <id> | Remove a toolchain |
rusty env list | List installed toolchains |
rusty env show | Active toolchain, host triple, rusty home |
rusty env which <prog> | Path to <prog> in active toolchain |
rusty env use <id> | Set default toolchain |
| Command | Description |
|---|
rusty init [name] [--format cargo|rusty] [--kind KIND] [--edition YYYY] | Scaffold a project |
rusty migrate [--yes] [--dry-run] | Convert Cargo → rusty manifests |
rusty lock | Generate or update lockfile |
rusty fetch | Resolve (if needed) + ingest deps into CAS |
rusty build, run, check | Native driver when supported; else cargo |
rusty test [FILTER]... | Native test runner (never cargo); see Test |
rusty test -p PKG --workspace | Multi-package testing |
rusty test --affected [base] | Test packages changed since base (+ reverse deps) |
rusty test --affected-direct [base] | Test path-touched packages only |
rusty test -j N | Shared compile+run job budget (RUSTY_JOBS / CARGO_BUILD_JOBS) |
rusty test --shard k/n | Run 1-based unit-plan shard k of n |
rusty test --reporter junit=PATH | Write JUnit XML report |
rusty test --retries N | Re-run failed test binaries up to N times |
rusty add <crate> [--vers REQ] | Add dependency (native for rusty.json) |
rusty rm, update | Dependency verbs (passthrough) |
rusty install <crate>[@version] | Prebuilt binary when available, else cargo install |
web, cli, tui, lib, fullstack, blank
| Command | Description |
|---|
rusty store path | Print store root |
rusty store stats | Blob count + size |
rusty store put <file> | Ingest file, print digest |
rusty store get <digest> | Dump blob to stdout |
rusty store has <digest> | Exit 0 if present |
rusty store gc [--dry-run] [--keep-ref <id>] | Reclaim unreferenced blobs |
rusty store tree put <dir> | Ingest directory tree |
rusty store tree get <hex> <dest> | Materialize tree |
rusty store tree ls <hex> | List tree entries |
rusty store crate ingest <n> <v> <src> | Ingest .crate tarball |
rusty store crate materialize <n> <v> <dest> | Extract crate to path |
rusty store crate list | List ingested crates |
| Command | Description |
|---|
rusty layers list [--profile p] | Cached crate layers |
rusty layers plan [--profile p] | Forecast hit/miss |
rusty layers why <id> [--profile p] | Layer key for name@version |
| Command | Description |
|---|
rusty cache path | Artifact cache root |
rusty cache key [--source <hex>] ... | Artifact key for inputs |
rusty cache put <key-hex> <out-dir> | Store artifact group |
rusty cache get <key-hex> <dest> | Restore artifact group |
rusty cache has <key-hex> | Exit 0 if cached |
rusty cache stats | Artifact statistics |
rusty cache wrap | RUSTC_WRAPPER entry (via rusty-wrapper) |
Put $RUSTY_HOME/bin on PATH after rusty env use. Shims dispatch cargo, rustc, rustdoc, etc. Override with +toolchain or RUSTY_TOOLCHAIN.
| Command | Description |
|---|
rusty proxy <prog> [args...] | Exec active toolchain binary |
| Command | Description |
|---|
rusty workspace list | List workspace members |
rusty workspace affected [base] | Crates changed since <base> |
rusty workspace affected --reverse | Include reverse dependents |
rusty workspace dependents <crate> | Who depends on <crate> |
rusty workspace unify | Version-drift report |
rusty workspace test-plan [base] | Print rusty test -p … for affected set (same packages as --affected) |
These verbs spawn cargo with rusty-managed environment when applicable:
build, run, check, clippy, fmt, doc, bench, tree, and other unrecognized commands.
Build-related passthrough runs fetch preparation, sets CARGO_HOME, CARGO_TARGET_DIR, RUSTC_WRAPPER, and passes --offline when sources are prepared.