Reference
Project layout
Files and directories rusty creates in a workspace and in RUSTY_HOME.
Workspace (per project)
my-workspace/
├── rusty.json # rusty manifest (or Cargo.toml)
├── rusty.lock # resolved graph (or Cargo.lock)
├── src/
└── .rusty/ # project-local rusty data
├── target/ # build outputs (replaces ./target)
├── layers/ # per-crate layer index
└── ... # lock digest, graph cache, metadataCARGO_TARGET_DIR points at .rusty/target during rusty-driven builds so artifacts stay inside the project cache root.
Global (RUSTY_HOME)
Default: ~/.rusty
~/.rusty/
├── bin/
│ ├── cargo # shim → rusty
│ ├── rustc # shim → rusty
│ └── rusty-wrapper # RUSTC_WRAPPER entry
├── store/ # content-addressable blobs (sharded by digest)
├── cache/ # compiled artifact groups
└── toolchains/
└── stable-.../ # installed compiler treeManifest formats
| Format | Manifest | Lockfile | Native driver |
|---|---|---|---|
rusty | rusty.json | rusty.lock | Preferred |
cargo | Cargo.toml | Cargo.lock | Passthrough + CAS env |
What not to commit
Add to .gitignore (rusty init templates may include these):
.rusty/Commit manifests and lockfiles. The global store and cache under RUSTY_HOME are machine-local and shared across projects on the same host.