diff --git a/src/core/prompts/system-prompt/__tests__/__snapshots__/anthropic_claude_sonnet_4-basic.snap b/src/core/prompts/system-prompt/__tests__/__snapshots__/anthropic_claude_sonnet_4-basic.snap
index f1cab97be4..ced39da888 100644
--- a/src/core/prompts/system-prompt/__tests__/__snapshots__/anthropic_claude_sonnet_4-basic.snap
+++ b/src/core/prompts/system-prompt/__tests__/__snapshots__/anthropic_claude_sonnet_4-basic.snap
@@ -266,6 +266,23 @@ Usage:
HEAD
+## use_subagents
+Description: Run up to five focused in-process subagents in parallel. Each subagent gets its own prompt and returns a comprehensive research result with tool and token stats.
+Parameters:
+- prompt_1: (required) First subagent prompt.
+- prompt_2: (optional) Optional second subagent prompt.
+- prompt_3: (optional) Optional third subagent prompt.
+- prompt_4: (optional) Optional fourth subagent prompt.
+- prompt_5: (optional) Optional fifth subagent prompt.
+Usage:
+
+
+
+
+
+
+
+
# Tool Use Examples
## Example 1: Requesting to execute a command
diff --git a/src/core/prompts/system-prompt/__tests__/__snapshots__/anthropic_claude_sonnet_4-no-browser.snap b/src/core/prompts/system-prompt/__tests__/__snapshots__/anthropic_claude_sonnet_4-no-browser.snap
index d7f3de6075..1682516835 100644
--- a/src/core/prompts/system-prompt/__tests__/__snapshots__/anthropic_claude_sonnet_4-no-browser.snap
+++ b/src/core/prompts/system-prompt/__tests__/__snapshots__/anthropic_claude_sonnet_4-no-browser.snap
@@ -232,6 +232,23 @@ Usage:
HEAD
+## use_subagents
+Description: Run up to five focused in-process subagents in parallel. Each subagent gets its own prompt and returns a comprehensive research result with tool and token stats.
+Parameters:
+- prompt_1: (required) First subagent prompt.
+- prompt_2: (optional) Optional second subagent prompt.
+- prompt_3: (optional) Optional third subagent prompt.
+- prompt_4: (optional) Optional fourth subagent prompt.
+- prompt_5: (optional) Optional fifth subagent prompt.
+Usage:
+
+
+
+
+
+
+
+
# Tool Use Examples
## Example 1: Requesting to execute a command
diff --git a/src/core/prompts/system-prompt/__tests__/__snapshots__/anthropic_claude_sonnet_4-no-focus-chain.snap b/src/core/prompts/system-prompt/__tests__/__snapshots__/anthropic_claude_sonnet_4-no-focus-chain.snap
index 81e5f3afda..6592302880 100644
--- a/src/core/prompts/system-prompt/__tests__/__snapshots__/anthropic_claude_sonnet_4-no-focus-chain.snap
+++ b/src/core/prompts/system-prompt/__tests__/__snapshots__/anthropic_claude_sonnet_4-no-focus-chain.snap
@@ -240,6 +240,23 @@ Usage:
HEAD
+## use_subagents
+Description: Run up to five focused in-process subagents in parallel. Each subagent gets its own prompt and returns a comprehensive research result with tool and token stats.
+Parameters:
+- prompt_1: (required) First subagent prompt.
+- prompt_2: (optional) Optional second subagent prompt.
+- prompt_3: (optional) Optional third subagent prompt.
+- prompt_4: (optional) Optional fourth subagent prompt.
+- prompt_5: (optional) Optional fifth subagent prompt.
+Usage:
+
+
+
+
+
+
+
+
# Tool Use Examples
## Example 1: Requesting to execute a command
diff --git a/src/core/prompts/system-prompt/__tests__/__snapshots__/anthropic_claude_sonnet_4-no-mcp.snap b/src/core/prompts/system-prompt/__tests__/__snapshots__/anthropic_claude_sonnet_4-no-mcp.snap
index e00aedf411..a36ad50455 100644
--- a/src/core/prompts/system-prompt/__tests__/__snapshots__/anthropic_claude_sonnet_4-no-mcp.snap
+++ b/src/core/prompts/system-prompt/__tests__/__snapshots__/anthropic_claude_sonnet_4-no-mcp.snap
@@ -266,6 +266,23 @@ Usage:
HEAD
+## use_subagents
+Description: Run up to five focused in-process subagents in parallel. Each subagent gets its own prompt and returns a comprehensive research result with tool and token stats.
+Parameters:
+- prompt_1: (required) First subagent prompt.
+- prompt_2: (optional) Optional second subagent prompt.
+- prompt_3: (optional) Optional third subagent prompt.
+- prompt_4: (optional) Optional fourth subagent prompt.
+- prompt_5: (optional) Optional fifth subagent prompt.
+Usage:
+
+
+
+
+
+
+
+
# Tool Use Examples
## Example 1: Requesting to execute a command
diff --git a/src/core/prompts/system-prompt/__tests__/__snapshots__/cline_devstral-basic.snap b/src/core/prompts/system-prompt/__tests__/__snapshots__/cline_devstral-basic.snap
index a55c2b0f5b..a8c16bd1a2 100644
--- a/src/core/prompts/system-prompt/__tests__/__snapshots__/cline_devstral-basic.snap
+++ b/src/core/prompts/system-prompt/__tests__/__snapshots__/cline_devstral-basic.snap
@@ -297,6 +297,23 @@ Usage:
+## use_subagents
+Description: Run up to five focused in-process subagents in parallel. Each subagent gets its own prompt and returns a comprehensive research result with tool and token stats.
+Parameters:
+- prompt_1: (required) First subagent prompt.
+- prompt_2: (optional) Optional second subagent prompt.
+- prompt_3: (optional) Optional third subagent prompt.
+- prompt_4: (optional) Optional fourth subagent prompt.
+- prompt_5: (optional) Optional fifth subagent prompt.
+Usage:
+
+
+
+
+
+
+
+
# Tool Use Examples
## Example 1: Requesting to execute a command
diff --git a/src/core/prompts/system-prompt/__tests__/__snapshots__/cline_devstral-no-browser.snap b/src/core/prompts/system-prompt/__tests__/__snapshots__/cline_devstral-no-browser.snap
index fd8b480327..d4205b7371 100644
--- a/src/core/prompts/system-prompt/__tests__/__snapshots__/cline_devstral-no-browser.snap
+++ b/src/core/prompts/system-prompt/__tests__/__snapshots__/cline_devstral-no-browser.snap
@@ -263,6 +263,23 @@ Usage:
+## use_subagents
+Description: Run up to five focused in-process subagents in parallel. Each subagent gets its own prompt and returns a comprehensive research result with tool and token stats.
+Parameters:
+- prompt_1: (required) First subagent prompt.
+- prompt_2: (optional) Optional second subagent prompt.
+- prompt_3: (optional) Optional third subagent prompt.
+- prompt_4: (optional) Optional fourth subagent prompt.
+- prompt_5: (optional) Optional fifth subagent prompt.
+Usage:
+
+
+
+
+
+
+
+
# Tool Use Examples
## Example 1: Requesting to execute a command
diff --git a/src/core/prompts/system-prompt/__tests__/__snapshots__/cline_devstral-no-focus-chain.snap b/src/core/prompts/system-prompt/__tests__/__snapshots__/cline_devstral-no-focus-chain.snap
index 321560d3cc..57d6f6ba87 100644
--- a/src/core/prompts/system-prompt/__tests__/__snapshots__/cline_devstral-no-focus-chain.snap
+++ b/src/core/prompts/system-prompt/__tests__/__snapshots__/cline_devstral-no-focus-chain.snap
@@ -267,6 +267,23 @@ Usage:
+## use_subagents
+Description: Run up to five focused in-process subagents in parallel. Each subagent gets its own prompt and returns a comprehensive research result with tool and token stats.
+Parameters:
+- prompt_1: (required) First subagent prompt.
+- prompt_2: (optional) Optional second subagent prompt.
+- prompt_3: (optional) Optional third subagent prompt.
+- prompt_4: (optional) Optional fourth subagent prompt.
+- prompt_5: (optional) Optional fifth subagent prompt.
+Usage:
+
+
+
+
+
+
+
+
# Tool Use Examples
## Example 1: Requesting to execute a command
diff --git a/src/core/prompts/system-prompt/__tests__/__snapshots__/cline_devstral-no-mcp.snap b/src/core/prompts/system-prompt/__tests__/__snapshots__/cline_devstral-no-mcp.snap
index 6f0aa4dc5f..5081377f94 100644
--- a/src/core/prompts/system-prompt/__tests__/__snapshots__/cline_devstral-no-mcp.snap
+++ b/src/core/prompts/system-prompt/__tests__/__snapshots__/cline_devstral-no-mcp.snap
@@ -297,6 +297,23 @@ Usage:
+## use_subagents
+Description: Run up to five focused in-process subagents in parallel. Each subagent gets its own prompt and returns a comprehensive research result with tool and token stats.
+Parameters:
+- prompt_1: (required) First subagent prompt.
+- prompt_2: (optional) Optional second subagent prompt.
+- prompt_3: (optional) Optional third subagent prompt.
+- prompt_4: (optional) Optional fourth subagent prompt.
+- prompt_5: (optional) Optional fifth subagent prompt.
+Usage:
+
+
+
+
+
+
+
+
# Tool Use Examples
## Example 1: Requesting to execute a command
diff --git a/src/core/prompts/system-prompt/__tests__/__snapshots__/openai_gpt_3-basic.snap b/src/core/prompts/system-prompt/__tests__/__snapshots__/openai_gpt_3-basic.snap
index 57a8fe1ab9..68b8edfae8 100644
--- a/src/core/prompts/system-prompt/__tests__/__snapshots__/openai_gpt_3-basic.snap
+++ b/src/core/prompts/system-prompt/__tests__/__snapshots__/openai_gpt_3-basic.snap
@@ -266,6 +266,23 @@ Usage:
HEAD
+## use_subagents
+Description: Run up to five focused in-process subagents in parallel. Each subagent gets its own prompt and returns a comprehensive research result with tool and token stats.
+Parameters:
+- prompt_1: (required) First subagent prompt.
+- prompt_2: (optional) Optional second subagent prompt.
+- prompt_3: (optional) Optional third subagent prompt.
+- prompt_4: (optional) Optional fourth subagent prompt.
+- prompt_5: (optional) Optional fifth subagent prompt.
+Usage:
+
+
+
+
+
+
+
+
# Tool Use Examples
## Example 1: Requesting to execute a command
diff --git a/src/core/prompts/system-prompt/__tests__/__snapshots__/openai_gpt_3-no-browser.snap b/src/core/prompts/system-prompt/__tests__/__snapshots__/openai_gpt_3-no-browser.snap
index 0a95048c21..5c31a32069 100644
--- a/src/core/prompts/system-prompt/__tests__/__snapshots__/openai_gpt_3-no-browser.snap
+++ b/src/core/prompts/system-prompt/__tests__/__snapshots__/openai_gpt_3-no-browser.snap
@@ -232,6 +232,23 @@ Usage:
HEAD
+## use_subagents
+Description: Run up to five focused in-process subagents in parallel. Each subagent gets its own prompt and returns a comprehensive research result with tool and token stats.
+Parameters:
+- prompt_1: (required) First subagent prompt.
+- prompt_2: (optional) Optional second subagent prompt.
+- prompt_3: (optional) Optional third subagent prompt.
+- prompt_4: (optional) Optional fourth subagent prompt.
+- prompt_5: (optional) Optional fifth subagent prompt.
+Usage:
+
+
+
+
+
+
+
+
# Tool Use Examples
## Example 1: Requesting to execute a command
diff --git a/src/core/prompts/system-prompt/__tests__/__snapshots__/openai_gpt_3-no-focus-chain.snap b/src/core/prompts/system-prompt/__tests__/__snapshots__/openai_gpt_3-no-focus-chain.snap
index 0846a2a9ee..22858ef702 100644
--- a/src/core/prompts/system-prompt/__tests__/__snapshots__/openai_gpt_3-no-focus-chain.snap
+++ b/src/core/prompts/system-prompt/__tests__/__snapshots__/openai_gpt_3-no-focus-chain.snap
@@ -240,6 +240,23 @@ Usage:
HEAD
+## use_subagents
+Description: Run up to five focused in-process subagents in parallel. Each subagent gets its own prompt and returns a comprehensive research result with tool and token stats.
+Parameters:
+- prompt_1: (required) First subagent prompt.
+- prompt_2: (optional) Optional second subagent prompt.
+- prompt_3: (optional) Optional third subagent prompt.
+- prompt_4: (optional) Optional fourth subagent prompt.
+- prompt_5: (optional) Optional fifth subagent prompt.
+Usage:
+
+
+
+
+
+
+
+
# Tool Use Examples
## Example 1: Requesting to execute a command
diff --git a/src/core/prompts/system-prompt/__tests__/__snapshots__/openai_gpt_3-no-mcp.snap b/src/core/prompts/system-prompt/__tests__/__snapshots__/openai_gpt_3-no-mcp.snap
index 5f108b9f20..f74f4883de 100644
--- a/src/core/prompts/system-prompt/__tests__/__snapshots__/openai_gpt_3-no-mcp.snap
+++ b/src/core/prompts/system-prompt/__tests__/__snapshots__/openai_gpt_3-no-mcp.snap
@@ -266,6 +266,23 @@ Usage:
HEAD
+## use_subagents
+Description: Run up to five focused in-process subagents in parallel. Each subagent gets its own prompt and returns a comprehensive research result with tool and token stats.
+Parameters:
+- prompt_1: (required) First subagent prompt.
+- prompt_2: (optional) Optional second subagent prompt.
+- prompt_3: (optional) Optional third subagent prompt.
+- prompt_4: (optional) Optional fourth subagent prompt.
+- prompt_5: (optional) Optional fifth subagent prompt.
+Usage:
+
+
+
+
+
+
+
+
# Tool Use Examples
## Example 1: Requesting to execute a command
diff --git a/src/core/prompts/system-prompt/__tests__/__snapshots__/openai_gpt_5-basic.snap b/src/core/prompts/system-prompt/__tests__/__snapshots__/openai_gpt_5-basic.snap
index 1f38f29e94..1e4effece0 100644
--- a/src/core/prompts/system-prompt/__tests__/__snapshots__/openai_gpt_5-basic.snap
+++ b/src/core/prompts/system-prompt/__tests__/__snapshots__/openai_gpt_5-basic.snap
@@ -266,6 +266,23 @@ Usage:
HEAD
+## use_subagents
+Description: Run up to five focused in-process subagents in parallel. Each subagent gets its own prompt and returns a comprehensive research result with tool and token stats.
+Parameters:
+- prompt_1: (required) First subagent prompt.
+- prompt_2: (optional) Optional second subagent prompt.
+- prompt_3: (optional) Optional third subagent prompt.
+- prompt_4: (optional) Optional fourth subagent prompt.
+- prompt_5: (optional) Optional fifth subagent prompt.
+Usage:
+
+
+
+
+
+
+
+
# Tool Use Examples
## Example 1: Requesting to execute a command
diff --git a/src/core/prompts/system-prompt/__tests__/__snapshots__/openai_gpt_5-no-browser.snap b/src/core/prompts/system-prompt/__tests__/__snapshots__/openai_gpt_5-no-browser.snap
index ac2be78e3d..8fd744e9e3 100644
--- a/src/core/prompts/system-prompt/__tests__/__snapshots__/openai_gpt_5-no-browser.snap
+++ b/src/core/prompts/system-prompt/__tests__/__snapshots__/openai_gpt_5-no-browser.snap
@@ -232,6 +232,23 @@ Usage:
HEAD
+## use_subagents
+Description: Run up to five focused in-process subagents in parallel. Each subagent gets its own prompt and returns a comprehensive research result with tool and token stats.
+Parameters:
+- prompt_1: (required) First subagent prompt.
+- prompt_2: (optional) Optional second subagent prompt.
+- prompt_3: (optional) Optional third subagent prompt.
+- prompt_4: (optional) Optional fourth subagent prompt.
+- prompt_5: (optional) Optional fifth subagent prompt.
+Usage:
+
+
+
+
+
+
+
+
# Tool Use Examples
## Example 1: Requesting to execute a command
diff --git a/src/core/prompts/system-prompt/__tests__/__snapshots__/openai_gpt_5-no-focus-chain.snap b/src/core/prompts/system-prompt/__tests__/__snapshots__/openai_gpt_5-no-focus-chain.snap
index 8f21274ab4..a1863cea59 100644
--- a/src/core/prompts/system-prompt/__tests__/__snapshots__/openai_gpt_5-no-focus-chain.snap
+++ b/src/core/prompts/system-prompt/__tests__/__snapshots__/openai_gpt_5-no-focus-chain.snap
@@ -240,6 +240,23 @@ Usage:
HEAD
+## use_subagents
+Description: Run up to five focused in-process subagents in parallel. Each subagent gets its own prompt and returns a comprehensive research result with tool and token stats.
+Parameters:
+- prompt_1: (required) First subagent prompt.
+- prompt_2: (optional) Optional second subagent prompt.
+- prompt_3: (optional) Optional third subagent prompt.
+- prompt_4: (optional) Optional fourth subagent prompt.
+- prompt_5: (optional) Optional fifth subagent prompt.
+Usage:
+
+
+
+
+
+
+
+
# Tool Use Examples
## Example 1: Requesting to execute a command
diff --git a/src/core/prompts/system-prompt/__tests__/__snapshots__/openai_gpt_5-no-mcp.snap b/src/core/prompts/system-prompt/__tests__/__snapshots__/openai_gpt_5-no-mcp.snap
index 2c460b969c..061cc5ab47 100644
--- a/src/core/prompts/system-prompt/__tests__/__snapshots__/openai_gpt_5-no-mcp.snap
+++ b/src/core/prompts/system-prompt/__tests__/__snapshots__/openai_gpt_5-no-mcp.snap
@@ -266,6 +266,23 @@ Usage:
HEAD
+## use_subagents
+Description: Run up to five focused in-process subagents in parallel. Each subagent gets its own prompt and returns a comprehensive research result with tool and token stats.
+Parameters:
+- prompt_1: (required) First subagent prompt.
+- prompt_2: (optional) Optional second subagent prompt.
+- prompt_3: (optional) Optional third subagent prompt.
+- prompt_4: (optional) Optional fourth subagent prompt.
+- prompt_5: (optional) Optional fifth subagent prompt.
+Usage:
+
+
+
+
+
+
+
+
# Tool Use Examples
## Example 1: Requesting to execute a command
diff --git a/src/core/prompts/system-prompt/__tests__/__snapshots__/openrouter_arcee_ai_trinity_large_preview-basic.snap b/src/core/prompts/system-prompt/__tests__/__snapshots__/openrouter_arcee_ai_trinity_large_preview-basic.snap
index 96d22d6f23..f997825cee 100644
--- a/src/core/prompts/system-prompt/__tests__/__snapshots__/openrouter_arcee_ai_trinity_large_preview-basic.snap
+++ b/src/core/prompts/system-prompt/__tests__/__snapshots__/openrouter_arcee_ai_trinity_large_preview-basic.snap
@@ -275,6 +275,23 @@ Usage:
HEAD
+## use_subagents
+Description: Run up to five focused in-process subagents in parallel. Each subagent gets its own prompt and returns a comprehensive research result with tool and token stats.
+Parameters:
+- prompt_1: (required) First subagent prompt.
+- prompt_2: (optional) Optional second subagent prompt.
+- prompt_3: (optional) Optional third subagent prompt.
+- prompt_4: (optional) Optional fourth subagent prompt.
+- prompt_5: (optional) Optional fifth subagent prompt.
+Usage:
+
+
+
+
+
+
+
+
# Tool Use Examples
## Example 1: Requesting to execute a command
diff --git a/src/core/prompts/system-prompt/__tests__/__snapshots__/openrouter_arcee_ai_trinity_large_preview-no-browser.snap b/src/core/prompts/system-prompt/__tests__/__snapshots__/openrouter_arcee_ai_trinity_large_preview-no-browser.snap
index 2b719df780..df58cbbbf7 100644
--- a/src/core/prompts/system-prompt/__tests__/__snapshots__/openrouter_arcee_ai_trinity_large_preview-no-browser.snap
+++ b/src/core/prompts/system-prompt/__tests__/__snapshots__/openrouter_arcee_ai_trinity_large_preview-no-browser.snap
@@ -241,6 +241,23 @@ Usage:
HEAD
+## use_subagents
+Description: Run up to five focused in-process subagents in parallel. Each subagent gets its own prompt and returns a comprehensive research result with tool and token stats.
+Parameters:
+- prompt_1: (required) First subagent prompt.
+- prompt_2: (optional) Optional second subagent prompt.
+- prompt_3: (optional) Optional third subagent prompt.
+- prompt_4: (optional) Optional fourth subagent prompt.
+- prompt_5: (optional) Optional fifth subagent prompt.
+Usage:
+
+
+
+
+
+
+
+
# Tool Use Examples
## Example 1: Requesting to execute a command
diff --git a/src/core/prompts/system-prompt/__tests__/__snapshots__/openrouter_arcee_ai_trinity_large_preview-no-focus-chain.snap b/src/core/prompts/system-prompt/__tests__/__snapshots__/openrouter_arcee_ai_trinity_large_preview-no-focus-chain.snap
index c3a4b14962..4e6e179344 100644
--- a/src/core/prompts/system-prompt/__tests__/__snapshots__/openrouter_arcee_ai_trinity_large_preview-no-focus-chain.snap
+++ b/src/core/prompts/system-prompt/__tests__/__snapshots__/openrouter_arcee_ai_trinity_large_preview-no-focus-chain.snap
@@ -249,6 +249,23 @@ Usage:
HEAD
+## use_subagents
+Description: Run up to five focused in-process subagents in parallel. Each subagent gets its own prompt and returns a comprehensive research result with tool and token stats.
+Parameters:
+- prompt_1: (required) First subagent prompt.
+- prompt_2: (optional) Optional second subagent prompt.
+- prompt_3: (optional) Optional third subagent prompt.
+- prompt_4: (optional) Optional fourth subagent prompt.
+- prompt_5: (optional) Optional fifth subagent prompt.
+Usage:
+
+
+
+
+
+
+
+
# Tool Use Examples
## Example 1: Requesting to execute a command
diff --git a/src/core/prompts/system-prompt/__tests__/__snapshots__/openrouter_arcee_ai_trinity_large_preview-no-mcp.snap b/src/core/prompts/system-prompt/__tests__/__snapshots__/openrouter_arcee_ai_trinity_large_preview-no-mcp.snap
index a8092e3d86..c720a8c11a 100644
--- a/src/core/prompts/system-prompt/__tests__/__snapshots__/openrouter_arcee_ai_trinity_large_preview-no-mcp.snap
+++ b/src/core/prompts/system-prompt/__tests__/__snapshots__/openrouter_arcee_ai_trinity_large_preview-no-mcp.snap
@@ -275,6 +275,23 @@ Usage:
HEAD
+## use_subagents
+Description: Run up to five focused in-process subagents in parallel. Each subagent gets its own prompt and returns a comprehensive research result with tool and token stats.
+Parameters:
+- prompt_1: (required) First subagent prompt.
+- prompt_2: (optional) Optional second subagent prompt.
+- prompt_3: (optional) Optional third subagent prompt.
+- prompt_4: (optional) Optional fourth subagent prompt.
+- prompt_5: (optional) Optional fifth subagent prompt.
+Usage:
+
+
+
+
+
+
+
+
# Tool Use Examples
## Example 1: Requesting to execute a command
diff --git a/src/core/prompts/system-prompt/tools/subagent.ts b/src/core/prompts/system-prompt/tools/subagent.ts
index dbcd4473b4..b3e5a3ac82 100644
--- a/src/core/prompts/system-prompt/tools/subagent.ts
+++ b/src/core/prompts/system-prompt/tools/subagent.ts
@@ -10,7 +10,7 @@ const generic: ClineToolSpec = {
name: "use_subagents",
description:
"Run up to five focused in-process subagents in parallel. Each subagent gets its own prompt and returns a comprehensive research result with tool and token stats.",
- contextRequirements: (context) => Boolean(context.enableNativeToolCalls) && !context.isSubagentRun,
+ contextRequirements: (context) => !context.isSubagentRun,
parameters: [
{
name: "prompt_1",