An Agent Plugins client for OpenCode: loads, validates, and registers Agent Plugins packages, turning their skills and MCP servers into OpenCode capabilities.
An Agent Plugin is a portable, self-contained package that bundles agent
capabilities: a directory with a plugin.json manifest, optionally a
skills/ directory and an mcp.json file. opencode-agent-plugins lets
OpenCode use such packages as-is, without converting them to OpenCode's
native configuration.
The package has two parts:
- An OpenCode V2 plugin that runs at OpenCode startup: it resolves
each configured source, validates the package against the specification,
and registers its skills and MCP servers through OpenCode's plugin
context.
stdioMCP servers receivePLUGIN_ROOTand a persistentPLUGIN_DATAdirectory;streamable-httpservers become remote entries; unsupportedsseservers are skipped with a warning. MCP tools are available through Code Mode by default, like natively-configured servers. User-authored configuration always wins: a colliding name is never overwritten, and the host keeps the user entry. An MCP collision is reported as a warning and the plugin's entry is skipped; a skill collision with user config is invisible to transforms and is not reported by the client. - A CLI that installs, updates, and removes plugin sources and manages the client store.
The CLI ships in the opencode-agent-plugins npm package. Run it with
npx — no global install is required:
npx opencode-agent-plugins --helpRequirements: OpenCode 2 (the client is verified against the release
pinned in package.json), Node.js >= 26 for the CLI, and git for the
git-backed commands (install from a URL, check, update).
This example installs the Context7 plugin from a subpath of its repository:
npx opencode-agent-plugins install \
https://github.com/upstash/context7.git#:plugins/agent-plugins/context7The CLI fetches the source, validates it, and previews the skills and MCP servers that would be registered; on confirmation it registers the source in your OpenCode config and reloads a running OpenCode. If no service is running, restart OpenCode and the plugin's skill and MCP server are available in your sessions.
For the full walkthrough — including what the output looks like and how to verify the result — see the getting-started tutorial.
- Getting started tutorial — install your first plugin, step by step.
- Configuration reference — the plugin entry, options, sources, and the client store.
- CLI reference — commands, flags, statuses, and exit codes.
- Explanations — architecture, sources, registration, the CLI lifecycle, reload, failures, and testing.
- Guides:
- Development — local environment, build and test commands.
- Changelog — release history.
- AGENTS.md — AI-agent code guidelines and project structure.