From a27ffb20f0a740823142f7c79706efb81d75d287 Mon Sep 17 00:00:00 2001 From: "opencode-agent[bot]" <219766164+opencode-agent[bot]@users.noreply.github.com> Date: Wed, 15 Jul 2026 10:00:59 -0500 Subject: [PATCH] docs: document subagent depth (#37132) Co-authored-by: Aiden Cline --- packages/web/src/content/docs/config.mdx | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/packages/web/src/content/docs/config.mdx b/packages/web/src/content/docs/config.mdx index c1a69f5a86..8bf875b1f8 100644 --- a/packages/web/src/content/docs/config.mdx +++ b/packages/web/src/content/docs/config.mdx @@ -538,6 +538,21 @@ This setting applies across all interfaces: TUI, CLI (`opencode run`), desktop a --- +### Subagent depth + +You can control how deeply subagents can invoke other subagents using the `subagent_depth` option. + +```json title="opencode.json" +{ + "$schema": "https://opencode.ai/config.json", + "subagent_depth": 2 +} +``` + +The default is `1`, which allows primary agents to launch subagents but prevents those subagents from launching additional subagents. Set it to `2` to allow one additional level of nested subagents, or `0` to prevent all subagent launches. + +--- + ### Sharing You can configure the [share](/docs/share) feature through the `share` option.