Subagents
Subagents
.cursor/agents/*.md
Vendor docs
frontmatter
| name | type | required | meaning | concept | |
|---|---|---|---|---|---|
| description | string |
Short description shown in Task tool hints. Agent reads this to decide delegation.
|
docs ↗ | ||
| is_background | boolean |
If `true`, the subagent runs in the background without blocking the parent.
|
docs ↗ | ||
| model | string |
Model to use: `inherit` or a specific model ID. See model configuration.
|
docs ↗ | ||
| name | string |
Display name and identifier. Use lowercase letters and hyphens.
|
docs ↗ | ||
| readonly | boolean |
If `true`, the subagent runs with restricted write permissions (no file edits, no state-changing shell commands).
|
docs ↗ |