| name | agent-creator |
| description | Create new OpenCode agents with a gpt-5.2-codex default. |
Quick Usage (Already Configured)
Create a project agent
opencode agent create
Agent file locations
- Project agents:
agents/<name>.md
- Global agents:
~/.config/opencode/agents/<name>.md
Default model
Use gpt-5.2-codex as the default model for new agents unless a workflow needs a different model.
Minimal agent template
---
description: One-line description of what the agent does
mode: subagent
model: gpt-5.2-codex
tools:
write: false
edit: false
bash: false
---
You are a specialized agent. Describe your task, boundaries, and expected output.
Notes from OpenCode docs
- Agent files are markdown with YAML frontmatter.
- The markdown filename becomes the agent name.
- Set
mode to primary, subagent, or all.
- If no model is specified, subagents inherit the caller model.
tools controls per-agent tool access.
Reference
Follow the official OpenCode agent docs: https://opencode.ai/docs/agents/
First-Time Setup (If Not Configured)
- Run
opencode agent create and choose project scope.
- Paste in the default template above and adjust tools as needed.