opencode-agents
Use when working with OpenCode agents — creating custom agents, configuring Build/Plan modes, subagents, agent properties (model, tools, permissions, prompts), or switching between agents.
| Model | Source |
|---|---|
| sonnet | pack: opencode |
Full Reference
OpenCode Agents
Section titled “OpenCode Agents”Agents are specialized AI assistants with custom prompts, models, and tool access. Two types: primary (direct interaction, Tab to switch) and subagents (invoked by primary agents or via @mention). Current version: v1.2.10 (Feb 2026).
Quick Reference
Section titled “Quick Reference”| Item | Value |
|---|---|
| Switch agents | Tab key or switch_agent keybind |
| Invoke subagent | @agent-name in message |
| Config location (global) | ~/.config/opencode/agents/ |
| Config location (project) | .opencode/agents/ |
| Create interactively | opencode agent create |
| List all agents | opencode agent list |
Built-in Agents
Section titled “Built-in Agents”| Agent | Type | Tools | Purpose |
|---|---|---|---|
| Build | Primary | All enabled | Full development (default) |
| Plan | Primary | Restricted (edit/bash = “ask”) | Analysis and exploration |
| General | Subagent | Full access | Complex multi-step research |
| Explore | Subagent | Read-only | Fast codebase analysis |
| Compaction | Hidden | System | Auto-compresses long context |
| Title | Hidden | System | Auto-generates session titles |
| Summary | Hidden | System | Auto-generates summaries |
Reference Index
Section titled “Reference Index”| Topic | File |
|---|---|
| Agent types — primary, subagent, hidden, mode values | reference/agent-types.md |
| Built-in agents — Build, Plan, General, Explore, system | reference/built-in-agents.md |
| All agent properties — description, model, steps, hidden, disable | reference/agent-properties.md |
| JSON and Markdown config formats, file locations, YAML gotchas | reference/configuration.md |
| Tool enable/disable, wildcard patterns, MCP tool namespacing | reference/tool-configuration.md |
| Permission values, bash patterns, task permission, conflict resolution | reference/permission-configuration.md |
| Per-agent model override, variants, model selection strategy | reference/model-configuration.md |
opencode agent create, agent list, manual file creation | reference/agent-creation-cli.md |
| Build, Plan, Review, Debug, Docs, Security, Haiku patterns | reference/design-patterns.md |
| Agent missing from UI, tool/permission conflicts, step limits | reference/troubleshooting.md |
Usage: Read the reference file matching your current task from the index above. Each file is self-contained with code examples and inline gotchas.
Announcement
Section titled “Announcement”┏━ 🤖 opencode-agents ━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ Create and configure OpenCode agents — modes, tools, permissions, prompts ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛