Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

cargo agents status

Show which plugins are enabled for this workspace, and why.

Usage

cargo agents status

Must be run from within a Rust workspace.

Behavior

Symposium separates two questions. Enablement asks whether a plugin may run at all; activation predicates ask when it applies. status reports both, one line per plugin, each naming its enablement root — so it answers “why is this here?” with “enabled via serde”.

Each line is in one of four states:

StateMeaning
activeEnabled and its predicates hold here. The root names the trust root: workspace membership, a configured registry, [plugins] auto-enable, or a [plugins] use entry.
dormantLoaded but contributing nothing: a registry plugin awaiting cargo agents use, or one whose predicates don’t currently hold.
candidateDiscovered in a dependency and awaiting consent. These are exactly what an interactive cargo agents sync asks about.
declinedRecorded in [plugins] disable — the record of pruned plugins and declined discoveries.

Discovery is cache-only, so a dependency whose source has not been fetched yet is simply not listed as a candidate. Enabling it by name still works.

With --json, each line is emitted as a plugin_status event carrying name, state, root, and — for a discovered dependency plugin — the resolved version.

Example

$ cargo agents status
✅ my-tool — workspace member
✅ serde-skills 1.0.0 — `[plugins] use`
💤 team-conventions — registry `user-plugins` (dormant: awaiting `cargo agents use`)
❓ widget-lib 0.3.1 — found via dependency `widget-lib`, awaiting consent (`cargo agents use widget-lib`)
➖ noisy-crate — declined (`[plugins] disable`)