Codex — Agents
- File format
- TOML
- Discovery path
-
.codex/agents - Global install path
-
~/.codex - Syllago install method
- Symlink, Direct copy
- Symlink support
- Yes
Features
How each feature converts to syllago's canonical format. See format conversion for what these statuses mean.
Fields
Native frontmatter or config fields this provider exposes. The first column is the provider's own field name; the canonical key column links to syllago's cross-provider equivalent.
| Provider field | Conversion | Canonical key | Summary |
|---|---|---|---|
agents | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | — | Named sub-agent roles declared in config.toml [agents] (description, config_file, nickname_candidates) plus global limits (max_threads, max_depth, job_max_runtime_seconds). |
config_file | Not portable Conversion type: Not portable Unique to this provider — can’t be carried across providers. Learn more → | — | A role's config_file is loaded as a high-precedence config layer overriding model, reasoning effort, and developer instructions for that spawned agent. |
features.multi_agent_v2 | Not portable Conversion type: Not portable Unique to this provider — can’t be carried across providers. Learn more → | — | Feature flag features.multi_agent_v2 (bool or object with enabled, hide_spawn_agent_metadata, usage_hint_enabled, usage_hint_text) gates the multi-agent system. |
Other features
Behaviors, conventions, and capabilities that aren't tied to a single named field — things like path-based activation, discovery rules, and lifecycle behavior.
| Feature | Conversion | Summary |
|---|---|---|
agent_scopes | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | built-in roles always available; user-defined roles in config.toml [agents] section; user-defined roles override built-in roles of same name |
definition_format | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | TOML role config files referenced from config.toml [agents] section; built-in roles (default/explorer/worker) always available without user config |
invocation_patterns | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | spawn-agent tool at LLM discretion; LLM selects role from dynamically-built role descriptions combining built-in and user-defined roles |
model_selection | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | role config_file can override model and model_reasoning_effort; caller's current profile and model_provider preserved unless explicitly overridden |
subagent_spawning | Translated Conversion type: Translated Actively mapped to the target provider’s equivalent field during conversion. Learn more → | multi-agent V2 feature flag; max_threads controls concurrent agent count, max_depth controls nesting depth; spawn-agent tool initiates delegation |
| Built-in Agent Roles (default, explorer, worker) | Not portable Conversion type: Not portable Unique to this provider — can’t be carried across providers. Learn more → | Three built-in roles always available without config: default (standard), explorer (fast read-focused, low reasoning), and worker (execution); awaiter exists but is disabled. |
| Spawn Tool Role Description Generation | Not portable Conversion type: Not portable Unique to this provider — can’t be carried across providers. Learn more → | The spawn-agent tool description is built dynamically at session start from all role descriptions and locked settings; user roles override built-in roles by name. |