Marketplaces & plugins

This is where agentsync earns its keep. A plugin is a bag of components — MCP servers, skills, subagents, commands, hooks, LSP servers. Install it once and every enabled agent gets the components it understands.

Install a plugin

1. Add a marketplace (a registry of plugins):

   agentsync marketplace add github:anthropics/claude-plugins-official

2. Install a plugin from it:

   agentsync plugin install atlassian@anthropic

3. Fetch from the network — update is the only networked verb:

   agentsync update

4. Apply — renders from the local cache to all agents:

   agentsync apply

update fetches, apply renders

update is the only command that touches the network. It refreshes the local plugin cache and recomputes version pins. apply then renders entirely from that cache — so it’s fast, offline, and reproducible. See Updating from the network.

The translation report

Each component in a plugin is projected independently per agent — fully, lossily, or skipped — and the report tells you exactly which:

plugin: atlassian@anthropic
  claude    ✓ full    (1 mcp, 5 commands)
  opencode  ◐ partial (1 mcp; 5 commands → projected)

Inspect a plugin’s coverage without applying:

agentsync explain atlassian@anthropic
agentsync explain atlassian@anthropic --json

Controlling per-plugin fan-out

Limit a plugin to specific agents with an agents = [...] allowlist in its TOML file:

~/.agentsync/plugins/atlassian.toml

id     = "atlassian@anthropic"
agents = ["claude"]   # only fan this plugin out to Claude

Per-component overrides are not wired in v1

A per-component [plugin.overrides.<agent>] table was specced but the projector does not consult it in v1 — use the agents allowlist instead.

Plugin lifecycle

agentsync plugin install <id[@marketplace]>
agentsync plugin upgrade  <id>
agentsync plugin enable   <id>
agentsync plugin disable  <id>
agentsync plugin remove   <id>
agentsync plugin list

Agent capability matrix What each agent supports per component, what each ◐ loses, and how to read the report.