OpenCode Reference - OCX Documentation

Legacy reference: this page describes OCX 2 for OpenCode V1. For OCX 3 and OpenCode V2, see the V2 documentation.

Overview

This section provides a comprehensive reference for developers building with OpenCode and OCX components. It covers plugin development, configuration, agent setup, skills, custom tools, and extension patterns.

Sections

Topic	Description
Plugin Development	Build OpenCode plugins with hooks and tools
Configuration	`opencode.jsonc` options and variable substitution
Agents	Agent types, configuration, and permissions
Skills & Instructions	Reusable AI instruction sets and discovery
Custom Tools	Custom tool implementations for AI agents
MCP Servers	Model Context Protocol server configuration
Permissions	Fine-grained access control for tools and agents

Quick Links

CLI Reference — OCX command-line interface
Creating Registries — Build and distribute registries
Profiles Overview — Profile concepts and configuration