agent_scopes
Where agent definitions can live and the priority ordering when definitions exist at multiple levels. Common scopes: project, user/personal, managed/enterprise, CLI-defined.
Type: object Content type: agents
Provider Support
Section titled “Provider Support”| Provider | Supported | Mechanism |
|---|---|---|
| claude-code | ✓ | 5 scopes (highest-first): managed settings (org-wide), CLI --agents flag (session), project (.claude/agents/), user (~/.claude/agents/), plugin; highest-priority wins on name collision |
| codex | ✓ | built-in roles always available; user-defined roles in config.toml [agents] section; user-defined roles override built-in roles of same name |
| copilot-cli | ✓ | project scope (.github/agents/ or .claude/agents/), personal (~/.copilot/agents/), plugin (agents/); personal takes precedence over project |
| cursor | ✓ | Two scopes: project (.cursor/agents/) and user-global (~/.cursor/agents/). |
| factory-droid | ✓ | project (.factory/droids/) overrides personal (~/.factory/droids/) on name collision — reverse of skills precedence |
| kiro | ✓ | project (.kiro/agents/) + global (~/.kiro/agents/); global overrides local on name collision — reverse of most Kiro content types |
| opencode | ✓ | Two scopes: project (.opencode/agents/) and user-global (~/.config/opencode/agents/). Both scopes are loaded and coexist. |
| roo-code | ✓ | Two scopes: project (.roomodes at the project root) and global (custom_modes.yaml in Roo Code's settings dir); project entries override global entries with the same slug |
| crush | ✗ | not documented |
| windsurf | ✗ | not documented |
| zed | ✗ | not documented |