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 ↗ |