agentos.guide › blog
OpenCode subagents are helper agents that your main agent launches into child sessions, and as of v2.3.0 they always run in the background and report back when they finish.
Book a free SEO strategy session →
This guide gives you three ready-to-paste subagents, the permission rules to keep them safe, and the prompts to call them.
If you would like agents like these working on your website's SEO, book a free SEO strategy session.
Everything is based on OpenCode's agents documentation.
According to the v2.3.0 release notes, subagents return their session ID immediately, carry on in the background and report whenever they go idle.
v2.3.1 added that timed-out shell commands move to the background rather than being killed.
Each subagent starts with fresh context in its own child session, and uses its own permissions.
Save as .opencode/agents/seo-audit.md.
---
description: Audits HTML pages for title, meta, headings and alt text
mode: subagent
permissions:
- action: edit
resource: "*"
effect: deny
- action: shell
resource: "*"
effect: deny
---
For each HTML file I name, report:
- title length and whether it contains the main topic
- meta description length
- exactly one h1
- images missing alt text
Return one table, worst pages first.
Call it with: "Use the seo-audit subagent on every page in /blog."
Save as .opencode/agents/link-check.md.
---
description: Finds broken internal links in the site source
mode: subagent
steps: 15
permissions:
- action: edit
resource: "*"
effect: deny
---
Scan the site files for internal links. List any link whose
target file does not exist, with the source file and line.
Do not fix anything.
Save as .opencode/agents/changelog.md.
---
description: Drafts a plain-English changelog from recent changes
mode: subagent
---
Read the current changes and write a short changelog for
non-technical readers: what changed, why it matters, and
anything they need to do. UK spelling. No jargon.
📞 Fancy agents auditing your site every week?
We will show you the setup Goldie Agency runs for clients. Book a free SEO strategy session with Goldie Agency.
Because subagents now run in the background, you can launch them together.
Use seo-audit on /blog, link-check on the whole site and
changelog on my current changes. Report each result as it
arrives, then give me a combined to-do list.
Book a free SEO strategy session →
The parent's subagent permission controls which children it may launch, following OpenCode's permissions rules, where the last matching rule wins.
{
"agents": {
"build": {
"permissions": [
{ "action": "subagent", "resource": "*", "effect": "deny" },
{ "action": "subagent", "resource": "seo-audit", "effect": "allow" },
{ "action": "subagent", "resource": "link-check", "effect": "allow" },
{ "action": "subagent", "resource": "changelog", "effect": "allow" },
{ "action": "subagent", "resource": "explore", "effect": "allow" }
]
}
}
}
Put that in opencode.jsonc; the config docs explain where config files are read from.
🔥 Want more ready-made agents like these?
Members install agent workflows straight into the Agent OS. Inside the AI Profit Boardroom you get step-by-step video trainings, the installable Agent OS, four coaching calls a week and 3,400+ members.
OpenCode includes General, for research and multi-step work, which cannot launch further subagents, and Explore, which searches and reads without editing.
V2 has no built-in scout agent.
steps caps how many model steps a helper can take.model picks a model as provider/model#variant; otherwise the parent's model is inherited.hidden: true hides a helper from listings, but does not restrict it.tools or maxSteps; see the migration notes.For a complete agent setup for business tasks, see the AI Profit Boardroom.
Book a free SEO strategy session →
Yes. Since v2.3.0 they always run in the background, return their session ID immediately and report to the parent when they go idle.
General, for research and multi-step work (it cannot launch more subagents), and Explore, which searches and reads without editing files.
In .opencode/agents/<name>.md for one project, or ~/.config/opencode/agents/<name>.md for all projects.
Yes. Since v2.3.0 they run in the background, so you can launch several in one prompt.
Paste in the three helpers above and you will have working OpenCode subagents in minutes; for agents applied to your SEO, book a free SEO strategy session.
About Julian
I'm Julian Goldie, an AI entrepreneur, SEO expert and the founder of the AI Profit Boardroom, which has 3,400+ members.
I help business owners scale with AI agents, automation and SEO.
My YouTube channel has 400,000+ subscribers, and I run Goldie Agency, a seven-figure SEO agency.
→ Hermes Agent Subagents: The Quick Start, And How They Fit Your Agent OS
→ Hermes Subagent Model: The Quick Start, And How To Set Worker Models In Your Agent OS
→ How To Get Cited By AI In Your Agent OS: A Quick Start, 5 Copy-Paste Prompts And A Weekly Loop
→ Best AI Visibility Tools In Your Agent OS: The Ranked List Plus 5 Copy-Paste Prompts
The installable system behind every guide on this site — dashboard, agents, memory and pipelines — updated as new tools land, with 3,400+ members and four coaching calls a week.
Join the AI Profit Boardroom →📺 Video notes + links to the tools 👉
🎥 Learn how I make these videos 👉