Start here
Rune
A fast, Cargo-compatible build system and package manager for Rust.
On this page
Where to start
Every page
Start with installation and the commands; everything else is reference.
| Page | What it covers |
|---|---|
| Installation | The install script and its options, building from source, shell completions, where Rune keeps its files |
| Commands | Everyday commands, Cargo's selection flags, help, the pager and progress display |
| Cargo compatibility | Manifests, dependencies, features, build scripts, native libraries, toolchains, profiles, resolution, the registry workflow — and the known limits |
| Manifests | Cargo.toml, or a Rune-only Rune.toml |
| Settings | rune config and every setting |
| Testing | How rune test runs tests, retries and flaky tests, cached test results, rune coverage |
| Caching | What goes into a unit's key, check after build, concurrent builds, feature unification, keeping the store small |
| Performance | How Rune uses cores and memory, and finding what makes a build long |
| CI and shared caches | Store bundles for CI, a store shared between machines, selective CI |
| Supply chain | Sandboxed build scripts, resolution, outdated/upgrade/unused, SBOMs, rune audit |
| Scripts | Single-file Rust scripts with dependencies |
| Editor integration | JSON messages, rust-analyzer, the build plan as JSON |
| Architecture | The crates Rune is made of, building and testing Rune itself |
| Benchmarks | rune-bench: measuring Rune against Cargo on generated and real projects |
ROADMAP.md has the status against the compatibility specification, measurements and what comes next; CHANGELOG.md what changed in each release.