Skip to main content
You can use rusty on Cargo projects without converting everything on day one.

Phase 1 — stay cargo-format

  1. Install rusty and a toolchain (Install).
  2. Enter the existing workspace root (Cargo.toml present).
  3. Use native PM verbs:
If build/check/run report unsupported shapes, that is intentional fail-closed behavior for cargo-format graphs not yet in the native matrix. Interop-only verbs still expect cargo on PATH:

Phase 2 — dry-run migration

Review the planned conversion to rusty.json + rusty.lock and which Cargo files would be removed.

Phase 3 — migrate

After migration:
  • Prefer rusty-format workflows and scripts in rusty.json.
  • Re-run rusty lock, rusty fetch, rusty build, rusty test.
  • Commit the new manifests and lockfile as you would any dependency change.

Scripts map

Many teams encode clippy/fmt/test policy in CI scripts. Under rusty-format, put them in rusty.json:
Then:

Rollback posture

Keep a git branch or tag before migrate --yes. Migration is intended to be deliberate; use --dry-run on large monorepos and migrate leaf packages first if you need a staged cutover.