config-basic.md +11 −13
148| Key | Default | Maturity | Description |148| Key | Default | Maturity | Description |
149| -------------------- | :-------------------: | ------------ | ---------------------------------------------------------------------------------------- |149| -------------------- | :-------------------: | ------------ | ---------------------------------------------------------------------------------------- |
150| `apps` | false | Experimental | Enable ChatGPT Apps/connectors support |150| `apps` | false | Experimental | Enable ChatGPT Apps/connectors support |
151151| `apps_mcp_gateway` | false | Experimental | Route Apps MCP calls through `https://api.openai.com/v1/connectors/mcp/` instead of legacy routing || `codex_hooks` | false | Under development | Enable lifecycle hooks from `hooks.json`. See [Hooks](https://developers.openai.com/codex/hooks). |
152152| `collaboration_modes` | true | Stable | Enable collaboration modes such as plan mode || `fast_mode` | true | Stable | Enable Fast mode selection and the `service_tier = "fast"` path |
153153| `multi_agent` | false | Experimental | Enable multi-agent collaboration tools || `multi_agent` | true | Stable | Enable subagent collaboration tools |
154| `personality` | true | Stable | Enable personality selection controls |154| `personality` | true | Stable | Enable personality selection controls |
155155| `remote_models` | false | Experimental | Refresh remote model list before showing readiness || `shell_snapshot` | true | Stable | Snapshot your shell environment to speed up repeated commands |
156| `runtime_metrics` | false | Experimental | Show runtime metrics summaries in TUI turn separators |
157| `request_rule` | true | Stable | Enable Smart approvals (`prefix_rule` suggestions) |
158| `search_tool` | false | Experimental | Enable `search_tool_bm25` so Codex discovers Apps MCP tools via search before tool calls |
159| `shell_snapshot` | false | Beta | Snapshot your shell environment to speed up repeated commands |
160| `shell_tool` | true | Stable | Enable the default `shell` tool |156| `shell_tool` | true | Stable | Enable the default `shell` tool |
161157| `use_linux_sandbox_bwrap` | false | Experimental | Use the bubblewrap-based Linux sandbox pipeline || `smart_approvals` | false | Experimental | Route eligible approval requests through the guardian reviewer subagent |
162158| `unified_exec` | false | Beta | Use the unified PTY-backed exec tool || `unified_exec` | `true` except Windows | Stable | Use the unified PTY-backed exec tool |
163159| `undo` | true | Stable | Enable undo via per-turn git ghost snapshots || `undo` | false | Stable | Enable undo via per-turn git ghost snapshots |
164| `web_search` | true | Deprecated | Legacy toggle; prefer the top-level `web_search` setting |160| `web_search` | true | Deprecated | Legacy toggle; prefer the top-level `web_search` setting |
165161| `web_search_cached` | true | Deprecated | Legacy toggle that maps to `web_search = "cached"` when unset || `web_search_cached` | false | Deprecated | Legacy toggle that maps to `web_search = "cached"` when unset |
166162| `web_search_request` | true | Deprecated | Legacy toggle that maps to `web_search = "live"` when unset || `web_search_request` | false | Deprecated | Legacy toggle that maps to `web_search = "live"` when unset |
167 163
168The Maturity column uses feature maturity labels such as Experimental, Beta,164The Maturity column uses feature maturity labels such as Experimental, Beta,
169 and Stable. See [Feature Maturity](https://developers.openai.com/codex/feature-maturity) for how to165 and Stable. See [Feature Maturity](https://developers.openai.com/codex/feature-maturity) for how to
171 167
172Omit feature keys to keep their defaults.168Omit feature keys to keep their defaults.
173 169
170For the current lifecycle hooks MVP, see [Hooks](https://developers.openai.com/codex/hooks).
171
174### Enabling features172### Enabling features
175 173
176- In `config.toml`, add `feature_name = true` under `[features]`.174- In `config.toml`, add `feature_name = true` under `[features]`.