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

symposium status

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

Usage

symposium status

Must be run from within a workspace, as symposium sync is.

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 five 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 symposium use, one whose predicates don’t currently hold, a dependency named by use that offers no plugin, or a use entry naming no registry plugin, dependency or cached crate (a symposium sync downloads a crate that is not cached yet).
candidateDiscovered in a dependency and awaiting consent. These are exactly what an interactive symposium sync asks about.
declinedRecorded in [plugins] disable — the record of pruned plugins and declined discoveries.
revokedThe audits list revokes this release or payload of a crate, for the reason shown. It is not loaded and not offered for consent, whatever use or auto-enable say. disable outranks it: a crate that is both shows as declined.

The line of a discovered dependency plugin, or of a cached crate used without being a dependency, ends with what the audits list says about it, in the words the consent prompt uses: audited by the `symposium-audits` list, not audited, or, when the list audits the crate but this payload cannot be checked against an audit, not audited: ... with the reason. When no list was read (the list is off, the default, or has never been fetched), no line has an audit part, since nothing was checked. A revoked line has no audit part, since its root already says who revoked it and why, and neither has a declined crate that is also revoked. Nor do lines that are not looked up: plugins from a registry or the workspace (trust roots), a used crate that is not cached yet, a used dependency that offers no plugin, and a declined name discovery never saw. An audit changes nothing else: an audited candidate is still a candidate.

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.

A revoked crate that is only reached through another plugin’s [[plugins]] chain, not named by a dependency or a use entry, is not listed.

With --json, each line is emitted as a plugin_status event carrying name, state (active, dormant, candidate, declined or revoked), root, a version when one is known (the resolved version for a discovered dependency plugin, the manifest’s for the others), audit on every line whose human form shows an audit part (exactly that text), and "format": "agent plugin" for a plugin that is an Agent Plugins package, which the human output shows after its name and version.

Example

$ symposium status
✅ my-tool — workspace member
✅ serde-skills 1.0.0 — `[plugins] use` — not audited
💤 team-conventions — registry `user-plugins` (dormant: awaiting `symposium use`)
❓ widget-lib 0.3.1 — found via dependency `widget-lib`, awaiting consent (`symposium use widget-lib`) — not audited
➖ noisy-crate — declined (`[plugins] disable`)
✅ tidy-crate 2.4.0 — `[plugins] auto-enable` — audited by the `symposium-audits` list
⛔ risky-crate 2.0.1 — revoked by the `symposium-audits` list: it tells the agent to fetch and run remote code