Run all of this inside the full Agent OS — join the AI Profit Boardroom →

agentos.guide › blog

OpenCode Subagents: Three Copy-Paste Agents and the Prompts to Run Them

By Julian Goldie · 18 November 2026 · agentos.guide

Gold branching nodes representing helper agents over dark aubergine

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.

How they work now

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.

Subagent 1: SEO page auditor

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."

Subagent 2: link checker

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.

Subagent 3: changelog writer

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.

→ Book your free SEO strategy session

Run all three at once

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 →

Lock down which helpers can be called

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.

→ Join the AI Profit Boardroom

Built-in helpers

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.

Useful settings

For a complete agent setup for business tasks, see the AI Profit Boardroom.

Book a free SEO strategy session →

FAQ

Do OpenCode subagents run in the background?

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.

Which subagents come built in?

General, for research and multi-step work (it cannot launch more subagents), and Explore, which searches and reads without editing files.

Where do I save a custom OpenCode subagent?

In .opencode/agents/<name>.md for one project, or ~/.config/opencode/agents/<name>.md for all projects.

Can I run several subagents at the same time?

Yes. Since v2.3.0 they run in the background, so you can launch several in one prompt.

Final word on OpenCode Subagents

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.

→ Get my best AI training inside the AI Profit Boardroom

Related guides on agentos.guide

→ 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

Get the whole Agent OS

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 👉

🆓 Get a FREE AI Course + Community + 1,000 AI Agents 👉

← all guides on agentos.guide