spawn_subagent
Creates a record with a name and a goal.
This is bookkeeping. No second model runs.
- Tool name
- spawn_subagent
- Group
- Sub-agent notes
- Risk
- none
- Needs approval
- never
- Approval rule
- No approval.
- Allowed in scheduled jobs
- No
- Default
- on
Parameters
| Name | Type | Required | Default | Meaning | Limits |
|---|---|---|---|---|---|
| name | string | Yes | A short name. | ||
| goal | string | Yes | What the sub-agent is meant to achieve. |
Returns
The sub-agent id.
Example (made up for this page)
{
"name": "demo",
"goal": "demo"
}Spawned sub-agent a1b2c3d4 (research) for goal: compare two librariesSide effects
- Adds an in-memory record.
See also:Sub-agent notes tools
Checked against the source at commit f4fd89f on 29 Oct 2026. Everything here is merged on the main branch; no release has been tagged yet. The source is private, so these pages are the public description.