Rustup
Apps & AutomationrustupRustup is an Agent Skill for apps & automation published in the carapace-sh/carapace-bin repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Use when working with the rustup CLI — the Rust toolchain multiplexer. Covers installing/updating/uninstalling toolchains, channel syntax (stable/beta/nightly, dated, versioned), cross-compilation targets, components and profiles, directory and file overrides (rust-toolchain.toml), the proxy/shim dispatch system (cargo/rustc/rustdoc/rustfmt/rust-analyzer), `rustup run`, `+toolchain` shorthand, self-management, shell completions, and environment variables. Triggers on: "rustup", "rustup install", "rustup update", "rustup toolchain", "rustup target", "rustup component", "rustup override", "rustup run", "rustup which", "rustup doc", "rustup man", "rustup self", "rustup show", "rustup set", "rustup home", "rustup completions", "rustup check", "rustup default", "+toolchain", "rust-toolchain.toml", "RUSTUP_HOME", "RUSTUP_TOOLCHAIN", "RUSTUP_AUTO_INSTALL", "rustup profile", "rustup proxy", "rust-analyzer proxy", "cargo-miri".
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/carapace-sh/carapace-bin/blob/HEAD/skills/rustup/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/rustup, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
rustup In-Depth Reference
Reference for rustup — the Rust toolchain installer and multiplexer. Covers the full CLI surface, the proxy dispatch system, toolchain resolution, cross-compilation, and configuration.
Data Flow
Command line
→ rustup binary (multi-call: arg0 selects mode)
→ rustup_mode : rustup <subcommand> ... (management)
→ proxy_mode : cargo / rustc / ... (tool dispatch)
→ setup_mode : rustup-init (installer)
→ toolchain resolution
1. +toolchain shorthand
2. RUSTUP_TOOLCHAIN env var
3. rustup override (dir override, closest wins)
4. rust-toolchain.toml / rust-toolchain file (closest wins)
5. default toolchain
→ install-on-run (if RUSTUP_AUTO_INSTALL=1)
→ exec real toolchain binary with configured env
Sub-Resources
Load the reference that matches your task. When in doubt, load multiple references.
| Keywords | Reference |
|---|---|
| install, uninstall, update, default, check, show, set, home, completions, help, global flags, --verbose, --quiet, --version, --no-self-update, top-level commands | references/cli.md |
| toolchain, install, uninstall, list, link, custom toolchain, channel, stable, beta, nightly, versioned, dated, target triple, host, spec syntax, toolchain name | references/toolchain.md |
| target, cross-compilation, target add, target list, target remove, rust-std, std library, linker, --target, --toolchain, --installed | references/target.md |
| component, add, remove, list, rustc, cargo, rustfmt, rust-docs, rust-analyzer, clippy, miri, rust-src, llvm-tools, rls, --target, --toolchain, profile, minimal, default, complete | references/component.md |
| override, override set, override unset, override list, rust-toolchain.toml, rust-toolchain file, toolchain resolution, precedence, RUSTUP_TOOLCHAIN, +toolchain, settings.toml, directory override | references/override.md |
| proxy, shim, cargo, rustc, rustdoc, rustfmt, rust-analyzer, clippy-driver, cargo-clippy, cargo-miri, rls, rust-gdb, rust-lldb, multi-call binary, rustup run, +toolchain shorthand, which, doc, man, install-on-run, recursion protection | references/proxy.md |
| environment variables, RUSTUP_HOME, CARGO_HOME, RUSTUP_TOOLCHAIN, RUSTUP_DIST_SERVER, RUSTUP_UPDATE_ROOT, RUSTUP_AUTO_INSTALL, RUSTUP_LOG, RUSTUP_TERM_COLOR, RUSTUP_IO_THREADS, settings.toml, configuration | references/environment.md |
Quick Guide
- How do I install a toolchain? → references/toolchain.md
- How do I switch the default toolchain? → references/cli.md
- How do I cross-compile to another target? → references/target.md
- How do I add clippy/rustfmt/rust-analyzer? → references/component.md
- How do I pin a toolchain per project? → references/override.md
- How does
cargo +nightly buildwork? → references/proxy.md - How does rustup decide which toolchain to use? → references/override.md
- How do I run a command with a specific toolchain? → references/proxy.md
- What components and profiles are available? → references/component.md
- What environment variables does rustup use? → references/environment.md
- How do I generate shell completions for rustup? → references/cli.md
- How do I update or uninstall rustup itself? → references/cli.md
Cross-Project References
- For cargo (the package manager/build tool proxied by rustup), see cargo's own documentation. This skill covers only rustup's proxy dispatch and environment setup for cargo, not cargo's command surface.
- For rust-analyzer as an LSP server (capabilities, configuration, extensions), see the rust-analyzer documentation. This skill covers only the rustup component/proxy aspect.