Symposium CLI
cargo agents matches a Rust project's dependencies to a plugin registry and installs the needed skills, hooks and MCP servers.
- 437 ★ on the repository
- Last commit
Extended access
Why this level
- The tool registers hooks in agents and installs skills and MCP servers from external sources.
- Auto-update is on by default.
Install
- Works in
Manual install
cargo binstall symposiumThe first README option installs a prebuilt binary; `cargo install symposium` works instead. The tool is invoked as `cargo agents`.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The tool registers hooks in agents and installs skills and MCP servers from external sources.
- Auto-update is on by default.
This is third-party code. Review the repository files before installing.
What it does
Symposium reads the workspace dependency graph through `cargo metadata` and looks for plugins whose conditions match your crates. Matching skills, hooks and MCP servers are installed into the selected agents and, with auto-sync on, refreshed on every hook invocation. Commands: `cargo agents init` records your agents and registers hooks, `sync` rebuilds the set, `plugin` manages sources and `crate-info` hands an agent a crate's source. A crate author can ship a plugin in the repository and Symposium picks it up with the dependency.
Who it is for. Rust developers who work with several agents and are tired of picking skills for each project library by hand.
Good fit when
- A project has dozens of crates and an agent needs guidance on using them properly.
- A team uses different agents, such as Codex CLI and Kiro, and the skill set must stay the same.
- A library author wants to ship agent instructions together with the crate.
- An agent needs the source of a specific crate version, not model memory.
Not a fit when
- The project is not written in Rust.
- Installing third-party hooks and MCP servers from registries is forbidden by security policy.
- Skills are picked by hand and must stay unchanged.
Example request
Run `cargo agents init`, pick Codex CLI and Claude Code, then `cargo agents sync` in this workspace and show which skills were installed.Limitations
It needs a Rust toolchain with `cargo` on `PATH` and at least one supported agent. Symposium installs third-party skills, hooks and MCP servers by plugin conditions, so review plugin sources. The `auto-update` setting is on by default: the tool installs a new version and re-executes, and you can switch it to `warn` or `off` in `~/.symposium/config.toml`. Global hooks apply to every Rust project, so choose the `project` scope if that is too broad.
How to disable. Remove agents from `~/.symposium/config.toml` or delete the Symposium hooks from agent settings, then `cargo uninstall symposium`. For one project the `project` hook scope is enough.
FAQ
Which agents are supported?
They include Antigravity CLI, Claude Code, Codex CLI, GitHub Copilot, Goose, Kiro and OpenCode. The full list is in the Supported agents section of the README.
What is the difference between `init` and `sync`?
`init` runs once per machine: it records agents and registers hooks. `sync` matches plugins against dependencies and refreshes skills, and with `auto-sync` the hook runs it.
How are plugin conditions defined?
With the `depends-on` field by crate name and version, such as `serde>=1.0`, and the `predicates` field with `shell`, `path_exists` and `env`, combined through `not`, `any` and `all`.
Is there an Arch Linux package?
The `symposium` package is in the official Arch repositories: `pacman -S symposium`. It provides the same `cargo-agents` binary.
How do I turn off auto-update?
Set `auto-update` to `off` or `warn` in `~/.symposium/config.toml`. The default is `on`: the tool installs a new version itself and re-executes.
Discussion
No questions or reviews yet.
Related
CLI toolsThree skills and a clippy config: an agent writes, reviews and ports idiomatic Rust, and CI enforces the checkable rules
A Rust SDK for coding agents and the ready-made abstract CLI: REPL, 34 tools, MCP, graph memory, Anthropic and OpenAI, JSON output for CI
Rust documentation MCP server: an agent searches crate items, reads source code and inspects the dependency tree.
A plugin runtime in Rust for software that changes itself: agents write and hot-reload plugins in TypeScript, Python, Go and Swift
rust-analyzer MCP: Rust code navigation for agents
r3bl-rust-analyzer-mcp-server
A Rust MCP server on standard threads: the agent gets hover info, go to definition, references, formatting and compiler diagnostics from rust-analyzer
A small terminal coding agent in Rust: bring your own API key or local model, per-turn cost, real undo and session branches
README in short
The tool matches a Rust project's dependency graph against a central recommendations repository and local plugin sources.