AI News
All stories
Official

Codex CLI 0.168.0 deprecates the multi_agent flag in favour of agents.enabled

Codex CLI 0.168.0 deprecates the features.multi_agent flag and warns users who set it explicitly to use agents.enabled to turn off subagent tools.

Products · · 1 min read

Codex CLI 0.168.0 now warns users who explicitly set features.multi_agent in their configuration. The warning points them to agents.enabled as the setting for turning off subagent tools. The change is listed under Chores in the release notes, which describe it in one sentence. The linked pull request shows more about what the flag does and when the warning fires.

Pull request #59479 marks [features].multi_agent as deprecated while leaving it enabled by default. The flag still controls the V1 fallback, so deprecating it does not switch that path off. The warning is emitted at startup when a user or project configuration explicitly sets the flag, and it recommends [agents].enabled = false for disabling subagent tools. One exception applies: when [features].multi_agent_v2 is enabled, the warning does not point to agents.enabled. Session-only overrides do not trigger the warning at all.

The pull request also describes its testing: configuration-loader coverage for explicit user and project settings, including a case where a project setting is overridden by a session flag, plus coverage for session-only overrides. It also updates the default-enabled feature check so that deprecated features are allowed through it. The pull request was opened and merged by copyberry[bot] on Nov 4, 2026.

The release notes do not say whether the old setting will eventually stop working. The pull request does not address a removal timeline either.

What changed

Codex CLI 0.168.0 marks features.multi_agent as deprecated, and explicit settings now trigger a startup warning that recommends [agents].enabled = false for disabling subagent tools.

Type: Breaking change · Applies to: Codex CLI 0.168.0, features.multi_agent, agents.enabled

Why it matters

Configurations that still set the old flag will show warnings and may need updating before the flag is removed.

What you can do

Check Codex configuration files for features.multi_agent and switch any subagent settings to agents.enabled.

Original source

Where we saw it

1 source

Codex CLI releases

AI wrote this summary from the sources listed, and nobody reviewed it individually before publication. Check the original source before you rely on it. How it works