Docs / Skills Reference / Subagent
Subagent
What it does
Spawns autonomous background agents that work independently on tasks. Your assistant can delegate work to parallel workers that run in the background.
Setup required
None. Works immediately.
Permissions
- Subagents inherit the same permission rules as your main assistant
Common prompts
| You say... | What happens |
|---|
| “Spawn an agent to research AI startups in healthcare” | Launches background research |
| “Start a background agent to monitor my inbox for the next hour” | Long-running background task |
| “Check on my research agent” | Gets status of a running subagent |
| “Cancel the background agent” | Aborts a running subagent |
Configuration
- Subagents can run in silent mode (no intermediate output) or verbose mode
- Status tracking: pending, running, completed, failed, aborted
- Results are delivered via follow-up message
Tips & gotchas
- Genuinely independent. Subagents run in the background while you continue chatting.
- No shared context. They can't access your current conversation's context unless you explicitly pass it.
- Great for long tasks. Deep research, monitoring, and batch processing are ideal use cases.
- Multiple agents. You can spawn multiple agents and check on them later.