Quick Usage (Already Configured)

Create a project agent

opencode agent create

Agent file locations

• Project agents: .opencode/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)

1. Run opencode agent create and choose project scope.
2. Paste in the default template above and adjust tools as needed.