Skip to content
aix

OpenCode support details

Native AGENTS.md rules, markdown commands, MCP, and skills with user-scope support.

OpenCode stays close to Claude-style commands and skills while keeping AGENTS.md as the rule surface.

Start on the full support matrix when you need to compare every editor at once. Use this page when you want the exact terms, support details, and project/user targets for OpenCode.

Related aix concepts: rules , prompts , mcp , skills , hooks .

Editor-specific notes

  • OpenCode uses opencode.json with a top-level mcp object instead of mcpServers.
  • Rules are written with section-managed markdown so user-owned AGENTS.md content is preserved.

Feature details

How to read the statuses

Support key

Editor support

  • Supported The editor exposes that feature at that scope.
  • No support The editor does not expose that feature at that scope.

aix support

  • Native aix writes the editor's own format.
  • Adapter aix keeps the feature through an adapter or alternate representation.
  • No support aix does not write that feature for the destination today.

Use the Project scope and User scope rows to see where config lands at each level.

Rules Learn the concept

Section-managed markdown in AGENTS.md.

OpenCode calls this AGENTS.md
aix support Native
Project
Editor Supported aix Native
Path AGENTS.md
User
Editor Supported aix Native
Path ~/.config/opencode/AGENTS.md

Prompts Learn the concept

Markdown command files with optional YAML frontmatter.

OpenCode calls this Commands
aix support Native
Project
Editor Supported aix Native
Path .opencode/commands/*.md
User
Editor Supported aix Native
Path ~/.config/opencode/commands/*.md

Supported metadata: description , argument-hint

MCP Learn the concept

JSON config with a top-level mcp object.

OpenCode calls this MCP servers
aix support Native
Project
Editor Supported aix Native
Path opencode.json
User
Editor Supported aix Native
Path ~/.config/opencode/opencode.json

Skills Learn the concept

Symlinked native skill directories backed by .aix/skills/.

OpenCode calls this Skills
aix support Native
Project
Editor Supported aix Native
Path .opencode/skills/{name}/
User
Editor Supported aix Native
Path ~/.config/opencode/skills/{name}/
  • OpenCode also discovers .agents/skills/ as a compatibility surface.

Agents

Markdown agent files with YAML frontmatter.

OpenCode calls this Agents
aix support Native
Project
Editor Supported aix Native
Path .opencode/agents/*.md
User
Editor Supported aix Native
Path ~/.config/opencode/agents/*.md

Supported metadata: description , mode , model , tools , permissions , editor.opencode

Hooks Learn the concept

Hooks are not supported.

OpenCode calls this Hooks
aix support No support
Project
Editor No support aix No support
Editor: The editor does not expose this feature at this scope. aix: OpenCode does not support lifecycle hooks in aix.
User
Editor No support aix No support
Editor: The editor does not expose this feature at this scope. aix: OpenCode does not support lifecycle hooks in aix.

AGENTS.md

OpenCode natively uses AGENTS.md for project and user instructions.

OpenCode calls this AGENTS.md
aix support Native
Project
Editor Supported aix Native
Path AGENTS.md
User
Editor Supported aix Native
Path ~/.config/opencode/AGENTS.md

.agents/skills

Compatibility with the shared Agent Skills folder convention.

OpenCode calls this .agents/skills
aix support Native
Project
Editor Supported aix Native
Path .agents/skills/{name}/
User
Editor Supported aix Native
Path Compatible home-scoped skill discovery

Related guides