AI Income Desk Join AIPB

OpenCode Subagents Explained Simply: AI Helpers That Work in the Background

A plain-English guide to OpenCode subagents for business owners and non-developers.

Julian Goldie — founder, AI Profit Boardroom
By Julian Goldie /5 min read
Get the AI Profit Stack Join AIPB →
  • 1,000+ done-for-you AI agent workflows
  • 5 live coaching calls / week with Julian
  • 7-day refund
  • 3,400+ AI operators inside

OpenCode subagents let one AI coding assistant hand jobs to helper assistants that work in the background, and this guide explains them for business owners who are not full-time developers.

Get Your Backlink Gameplan →Try Polar Rank Free for 3 Days →

Think of it like a manager with a team: the main agent talks to you, and the subagents go off to research, review or check things, then report back.

If you would like AI agents doing real work in your business, get your Backlink Gameplan and see how we use them for SEO, or try Polar Rank free for 3 days.

All the details come from OpenCode's official agents guide and its release notes.

What OpenCode is

OpenCode is an open-source AI coding assistant that runs in your terminal and desktop app.

You type what you want, and it reads files, writes code and runs commands, with your permission.

Subagents are what let it split a big job into smaller ones.

What changed this week

Version 2.3.0, released on 13 November 2026, made subagents always run in the background, according to the release notes.

That means you can keep chatting with the main agent while helpers work, and each one reports back when it is done.

Version 2.3.1 followed on 18 November, and its notes say long-running commands that hit their time limit now keep running in the background instead of being stopped.

The two helpers you get for free

HelperWhat it is for
GeneralResearch and multi-step jobs; it can use most tools but cannot start its own helpers
ExploreLooking through code or web pages without changing anything

You can use these straight away by asking, for example: "Use the explore subagent to find where we send order emails."

Making your own helper

You make a helper by saving a short text file in a folder called .opencode/agents inside your project.

The top of the file holds a few settings, and the rest is plain instructions for the helper.

---
description: Checks product pages for missing information
mode: subagent
---

Read the product page files I point you to. List any product
missing a description, an image alt text or a size guide.
Do not change any files.

Save it as .opencode/agents/page-checker.md.

Then ask your main agent: "Use the page-checker subagent on our product pages."

📞 Want AI helpers checking your website for you? Get your Backlink Gameplan and we will show you how agents can audit pages for SEO every week, or try Polar Rank free for 3 days. Backlink Gameplan or try Polar Rank free for 3 days

Get Your Backlink Gameplan →Try Polar Rank Free for 3 Days →

Why the description matters

OpenCode shows each helper's description to the main agent when it decides who to call.

A clear one-line description, like "Checks product pages for missing information", means the right helper gets picked.

A vague one, like "helper", means it might never be used.

Keeping helpers safe

Each helper can have its own permissions, which OpenCode explains in its permissions guide.

You can stop a helper from editing files or running commands, so it can only look and report.

This is the safest way to start, especially if you are new to AI coding tools.

permissions:
  - action: edit
    resource: "*"
    effect: deny
  - action: shell
    resource: "*"
    effect: deny

🔥 Want simple, step-by-step help setting up AI agents? 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. There are beginner-friendly trainings that walk through setups like this. → Join the AI Profit Boardroom

Ideas for helpers a small business could use

  • A page checker that finds missing product details.
  • A link checker that lists broken links on your website.
  • A writer that drafts release notes or update emails from recent changes.
  • A reviewer that reads changes before they go live and flags anything risky.

Choosing which AI model a helper uses

Each helper can use a different AI model, written as provider, model and an optional variant.

If you leave it out, the helper uses the same model as the main conversation, which is the simplest choice to start.

Things to watch out for

  • New helpers default to being a main agent, so remember to write mode: subagent.
  • Hiding a helper only hides it from lists; it does not stop it doing things. Use permissions for that.
  • Older guides may use settings that are now out of date; OpenCode's upgrade guide explains the changes.

If you want to go further, the AI Profit Boardroom has trainings on putting AI agents to work in a business.

Get Your Backlink Gameplan →Try Polar Rank Free for 3 Days →

FAQ: OpenCode Subagents Explained Simply

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.

Do I need to be a developer to use OpenCode subagents?

It helps, but a simple read-only helper only needs a short text file in your project folder.

Can a subagent change my files?

Only if its permissions allow it; you can deny editing and shell commands so it only reads and reports.

📺 Video notes + links to the tools 👉

🎥 Learn how I make these videos 👉

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

About Julian

I'm Julian Goldie, an SEO entrepreneur, author and founder of the AI Profit Boardroom, which has 3,400+ members.

I help business owners scale with AI agents, automation and SEO.

  • I've built a 7-figure SEO and link building agency, Goldie Agency, with a team of 70+ SEO experts.
  • I've grown a YouTube channel to 400,000+ subscribers.
  • I wrote "Link Building Mastery".
  • My Udemy courses have taught over 29,000 students.

→ Get my best AI training inside the AI Profit Boardroom

Start with one read-only helper and you will quickly see what OpenCode subagents can do for you; for agents working on your SEO, get your Backlink Gameplan, or try Polar Rank free for 3 days.

Member reviews · from Skool

What members say about the AI Profit Boardroom

Read the member reviews on Skool →
Ahmad Bukhari: Julian doesn't gatekeep. That's why I'd recommend this group. He's extremely active here, sharing what's working right now and jumping in to help anyone who's stuck. If he can give it away, he does. He keeps the vibe positive and pushes everyone to help each other. His challenges reward members for getting people unstuck, so the whole room shares knowledge, not just him. Want a generous, positive place to learn AI and actually use it? This is it. Thanks Julian!
Ahmad Bukhari
Julian doesn't gatekeep. That's why I'd recommend this group. He's extremely active here, sharing what's working right now and jumping in to help anyone who's stuck. If he can give it away, he does. He keeps the vibe positive and pushes everyone to help each other. His challenges reward members for getting people unstuck, so the whole room shares knowledge, not just him. Want a generous, positive place to learn AI and actually use it? This is it. Thanks Julian!

Still a paying member after 1 month

Jay Parsons: There are so many helpful members in this amazing community ready to help out with suggestions and solutions whenever someone asks a question. I am amazed at the progress I have made in learning AI. I came here to learn how to use AI better and apply what I learned to my business. I am learning so much more than I even dreamed of. I have built an Agentic OS and use it every day, and I have no background in coding. There are an incredible amount of useful tutorials on everything AI.
Jay Parsons
There are so many helpful members in this amazing community ready to help out with suggestions and solutions whenever someone asks a question. I am amazed at the progress I have made in learning AI. I came here to learn how to use AI better and apply what I learned to my business. I am learning so much more than I even dreamed of. I have built an Agentic OS and use it every day, and I have no background in coding. There are an incredible amount of useful tutorials on everything AI.

Still a paying member after 11 months

Brian O'Connor: At 47, with 30 years in sales and finance, embracing AI was exciting but overwhelming. While building a business to help others adopt AI, I found myself chasing tools and fearing I was falling behind. Julian and the AI Profit Boardroom helped me refocus through practical, personalized advice and a supportive community. I now feel more confident adapting to change while staying focused on my goals. Thank you, Julian, for bringing this community together!
Brian O'Connor
At 47, with 30 years in sales and finance, embracing AI was exciting but overwhelming. While building a business to help others adopt AI, I found myself chasing tools and fearing I was falling behind. Julian and the AI Profit Boardroom helped me refocus through practical, personalized advice and a supportive community. I now feel more confident adapting to change while staying focused on my goals. Thank you, Julian, for bringing this community together!

Still a paying member after 2 months

Neil Martin: This is a truly amazing community, thanks in no small part to Julian's prodigious output and tireless efforts to provide value to his subscribers. Nothing is too much trouble for him. If you ask a question it gets answered in short order usually with a custom video. I have been in quite a few groups and this level of service is unparalleled. If you are serious about getting an AI education, you need to be in this group!
Neil Martin
This is a truly amazing community, thanks in no small part to Julian's prodigious output and tireless efforts to provide value to his subscribers. Nothing is too much trouble for him. If you ask a question it gets answered in short order usually with a custom video. I have been in quite a few groups and this level of service is unparalleled. If you are serious about getting an AI education, you need to be in this group!

Still a paying member after 7 months

Crystal Hill: AIPB has inspired me to go beyond learning AI as individual tools, skills, and prompts, and start thinking in terms of larger systems. What I really appreciate is how responsive Julian is and how quickly the material evolves with the technology. You’re being exposed to the right tools and ideas as they emerge. AIPB has given me the confidence to learn, experiment, build, and think much bigger about what’s really possible with AI.
Crystal Hill
AIPB has inspired me to go beyond learning AI as individual tools, skills, and prompts, and start thinking in terms of larger systems. What I really appreciate is how responsive Julian is and how quickly the material evolves with the technology. You’re being exposed to the right tools and ideas as they emerge. AIPB has given me the confidence to learn, experiment, build, and think much bigger about what’s really possible with AI.

Still a paying member after 5 months

Maurice Morrison: AI Profit Board Room has been a game-changer. The insights are practical, timely, and focused on turning AI into real business results—not just theory or hype. The community is supportive, the guidance is clear, and I leave every session with ideas I can actually apply. If you’re serious about using AI to grow smarter and move faster, this is absolutely worth joining.
Maurice Morrison
AI Profit Board Room has been a game-changer. The insights are practical, timely, and focused on turning AI into real business results—not just theory or hype. The community is supportive, the guidance is clear, and I leave every session with ideas I can actually apply. If you’re serious about using AI to grow smarter and move faster, this is absolutely worth joining.

Still a paying member after 2 months

Jeremy Murdock: I have truly enjoyed my experience here. The group of folks on the calls is quite diverse and I find it comforting to know that I am not the only one going through the changes that are happening at a faster and faster pace. I have chosen to embrace the change and go full force into integrating AI and what I have learned form the group and Julian. I am also impressed and appreciative that he actually takes the time to help with challenges I have along the way and get involved personally!
Jeremy Murdock
I have truly enjoyed my experience here. The group of folks on the calls is quite diverse and I find it comforting to know that I am not the only one going through the changes that are happening at a faster and faster pace. I have chosen to embrace the change and go full force into integrating AI and what I have learned form the group and Julian. I am also impressed and appreciative that he actually takes the time to help with challenges I have along the way and get involved personally!

Still a paying member after 10 months

Michael Lovitch: I have been a part of a million ai groups in Skool for years now. They are all okay and have helped, but usually they get out of date and don't offer real service to help you through especially at the beginning. This group is different, Julian actually answers questions which is crazy! And although ai marketing moves at the speed of light, they stay current and actually help you keep up… Highly recommended!
Michael Lovitch
I have been a part of a million ai groups in Skool for years now. They are all okay and have helped, but usually they get out of date and don't offer real service to help you through especially at the beginning. This group is different, Julian actually answers questions which is crazy! And although ai marketing moves at the speed of light, they stay current and actually help you keep up… Highly recommended!

Still a paying member after 3 months

Hoebing Lo: I don't know of any other community that is as active and sharing. Julian is a star and he answers so many questions in lightning speed. If you want a great place to start with AI here it is. No question too simple. No workflow too complicated. The community is about action and results not education so if you are looking to win at AI then come for the ride of a lifetime!
Hoebing Lo
I don't know of any other community that is as active and sharing. Julian is a star and he answers so many questions in lightning speed. If you want a great place to start with AI here it is. No question too simple. No workflow too complicated. The community is about action and results not education so if you are looking to win at AI then come for the ride of a lifetime!

Still a paying member after 5 months

Darren Wagstaff: Very responsive... great personal support (not an ai chat bot). Very clear straight forward trainings in easy to understand actionable language. I'm in numerous Skool groups but this one has the most human and real community by far. No question gets ignored. You never fell like just another number. It's great to see so many members getting great results with Ai.
Darren Wagstaff
Very responsive... great personal support (not an ai chat bot). Very clear straight forward trainings in easy to understand actionable language. I'm in numerous Skool groups but this one has the most human and real community by far. No question gets ignored. You never fell like just another number. It's great to see so many members getting great results with Ai.

Still a paying member after 2 months

Rod Martin: Julian is brilliant, and more prolific than I can keep up with (which is a great thing). His AgentOS is remarkable, and he is THE go-to guy for what you can really do (and not do) with the ever-increasing deluge of new AI upgrades and tools. HIGHLY recommend.
Rod Martin
Julian is brilliant, and more prolific than I can keep up with (which is a great thing). His AgentOS is remarkable, and he is THE go-to guy for what you can really do (and not do) with the ever-increasing deluge of new AI upgrades and tools. HIGHLY recommend.

Still a paying member after 5 months

Yosuke Sato: The best Skool course you get for AI! I have attended a few Skool courses before, but AI Profit Boardroom is the most active community and has great support from the management team, including Julian! You can get the most up-to-date information and practical implementations in this community. I highly recommend this!
Yosuke Sato
The best Skool course you get for AI! I have attended a few Skool courses before, but AI Profit Boardroom is the most active community and has great support from the management team, including Julian! You can get the most up-to-date information and practical implementations in this community. I highly recommend this!

Still a paying member after 19 months

Your next move

Ready to build AI agents that actually make money?

Join 3,400+ entrepreneurs inside the AI Profit Boardroom. Get 1,000+ plug-and-play AI agent workflows, 5 live coaching calls a week, and a community that holds you accountable.

Join the AI Profit Boardroom →

7-day no-questions refund · Cancel anytime

Found this useful? Get more of this site in your Google.

One tap adds us as a preferred source — Google then shows you our posts more often in Search, Top Stories, and AI Overviews.

Or add us in your Google settings →

← Back to all posts