rustuse CLI
rustuse is the command-line tool for RustUse adoption workflows.
RustUse supports three distribution modes:
- Cargo mode installs a RustUse crate as a normal dependency. RustUse owns the crate; your project depends on it.
- Copy mode copies RustUse source into your project. Your project owns the copied source after adoption.
- CLI-assisted adoption helps find, add, copy, track, and inspect RustUse primitives. The CLI is not a package manager and does not replace Cargo.
This v0.1 scaffold is intentionally small. It parses the intended command surface, searches a placeholder in-memory index, prints docs URLs, and reports what commands would do. It does not edit Cargo.toml, copy source files, fetch network data, or create rustuse.lock yet.
Project tracking
rustuse.toml is optional human-editable project configuration. Cargo-only workflows and copy-only workflows do not require it.
Run rustuse init when you want managed RustUse project state. The command creates rustuse.toml, .rustuse/cache/, and .rustuse/snapshots/. It is idempotent, does not overwrite an existing config, and does not modify Cargo.toml, copy RustUse source, add dependencies, or create rustuse.lock.
Use rustuse init --copy-first to make copy mode the default in generated project configuration. Use rustuse init --dry-run to preview the files and directories without writing them.
Cargo subcommand
Installing rustuse-cli provides two binaries:
rustusecargo-rustuse
The second binary lets Cargo run RustUse as:
These are equivalent:
cargo rustuse is a Cargo-native entry point, not a separate package manager. It uses the same RustUse CLI implementation.
Examples
Global flags: