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

Provider	Supported	Mechanism
claude-code	✓	5 scopes (highest-first): managed settings (org-wide, priority 1), CLI --agents flag (current session, priority 2), project (.claude/agents/, priority 3), user (~/.claude/agents/, priority 4), plugin agents/ directory (priority 5); 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; top-level files only, no recursion
gemini-cli	✓	Two scopes: project (.gemini/agents/.md) and user/global (~/.gemini/agents/.md). Both directories are scanned at session start and merged into a single registry; explicit collision-precedence behavior is not documented upstream.
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/ or .opencode/agent/) 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
amp	✗	not documented
cline	✗	not documented
crush	✗	not documented
pi	✗	not documented
windsurf	✗	not documented
zed	✗	not documented