Skip to content

opencode-extensions

Use when extending OpenCode — MCP servers, plugins/hooks, custom commands, agent skills, rules/AGENTS.md, or migrating from Claude Code. Covers the full extensibility layer.

ModelSource
sonnetpack: opencode
Full Reference

OpenCode’s extensibility layer: MCP servers (external tools), plugins (hooks/events), custom commands (slash commands), agent skills (reusable instructions), and rules (AGENTS.md). Current version: v1.2.10 (Feb 2026).

I want to…File
Add an MCP server (local or remote)reference/mcp-servers.md
Configure MCP OAuthreference/mcp-servers.md
Disable or scope MCP toolsreference/mcp-servers.md
Write a plugin / hook into eventsreference/plugins.md
Register a custom tool via pluginreference/plugins.md
Inject env vars into shell executionsreference/plugins.md
Create a slash commandreference/custom-commands.md
Use template variables / shell injectionreference/custom-commands.md
Build an agent skill (SKILL.md)reference/agent-skills.md
Control skill permissionsreference/agent-skills.md
Set up AGENTS.md or project rulesreference/rules-and-agents-md.md
Load external instruction filesreference/rules-and-agents-md.md
Migrate from Claude Codereference/claude-code-migration.md
  • reference/mcp-servers.md — Local + remote MCP config, OAuth flows, tool control, troubleshooting
  • reference/plugins.md — Plugin structure, context object, all hooks, custom tools, env injection
  • reference/custom-commands.md — File format, frontmatter fields, template variables, JSON alternative
  • reference/agent-skills.md — Skill structure, SKILL.md frontmatter, discovery, permissions
  • reference/rules-and-agents-md.md — AGENTS.md search order, instructions config, remote URLs
  • reference/claude-code-migration.md — Auto-recognized files, compat env vars, migration checklist

Usage: Read the reference file matching your current task from the index above. Each file is self-contained with code examples and inline gotchas.


┏━ 🔌 opencode-extensions ━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ MCP servers, plugins, custom commands, skills, and rules for OpenCode ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛