rustuse-cli 0.1.0

RustUse command-line adoption helper.
Documentation

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:

  • rustuse
  • cargo-rustuse

The second binary lets Cargo run RustUse as:

cargo rustuse <command>

These are equivalent:

rustuse search geometry
cargo rustuse search geometry

rustuse add use-geometry
cargo rustuse add use-geometry

rustuse copy use-slug
cargo rustuse copy use-slug

cargo rustuse is a Cargo-native entry point, not a separate package manager. It uses the same RustUse CLI implementation.

Examples

rustuse init
rustuse init --copy-first
rustuse search geometry
rustuse info use-geometry
rustuse add use-geometry
rustuse copy use-slug
rustuse copy use-slug --with-tests
rustuse add use-slug --copy
rustuse add use-slug --copy --with-tests
rustuse list
rustuse docs use-math --workspace
rustuse doctor

Global flags:

rustuse --verbose search geometry
rustuse --quiet doctor
rustuse --json info use-geometry