subagents.md +2 −2
97Global subagent settings still live under `[agents]` in your [configuration](https://developers.openai.com/codex/config-basic#configuration-precedence).97Global subagent settings still live under `[agents]` in your [configuration](https://developers.openai.com/codex/config-basic#configuration-precedence).
98 98
99| Field | Type | Required | Purpose |99| Field | Type | Required | Purpose |
100100| --- | --- | --- | --- || -------------------------------- | ------ | :------: | ---------------------------------------------------------- |
101| `agents.max_threads` | number | No | Concurrent open agent thread cap. |101| `agents.max_threads` | number | No | Concurrent open agent thread cap. |
102| `agents.max_depth` | number | No | Spawned agent nesting depth (root session starts at 0). |102| `agents.max_depth` | number | No | Spawned agent nesting depth (root session starts at 0). |
103| `agents.job_max_runtime_seconds` | number | No | Default timeout per worker for `spawn_agents_on_csv` jobs. |103| `agents.job_max_runtime_seconds` | number | No | Default timeout per worker for `spawn_agents_on_csv` jobs. |
112### Custom agent file schema112### Custom agent file schema
113 113
114| Field | Type | Required | Purpose |114| Field | Type | Required | Purpose |
115115| --- | --- | --- | --- || ------------------------ | -------- | :------: | --------------------------------------------------------------- |
116| `name` | string | Yes | Agent name Codex uses when spawning or referring to this agent. |116| `name` | string | Yes | Agent name Codex uses when spawning or referring to this agent. |
117| `description` | string | Yes | Human-facing guidance for when Codex should use this agent. |117| `description` | string | Yes | Human-facing guidance for when Codex should use this agent. |
118| `developer_instructions` | string | Yes | Core instructions that define the agent's behavior. |118| `developer_instructions` | string | Yes | Core instructions that define the agent's behavior. |