CDX-CFG-029: Incompatible agents.max_threads with multi_agent_v2

Summary

• Rule ID: CDX-CFG-029
• Severity: HIGH
• Category: Codex CLI
• Normative Level: MUST
• Auto-Fix: No
• Verified On: 2026-05-04

Applicability

• Tool: codex
• Version Range: unspecified
• Spec Revision: unspecified

Evidence Sources

• https://github.com/openai/codex/pull/19129
• https://github.com/openai/codex/pull/19733
• https://github.com/openai/codex/pull/19792
• https://github.com/openai/codex/blob/rust-v0.128.0/codex-rs/core/src/config/mod.rs

Test Coverage Metadata

• Unit tests: true
• Fixture tests: false
• E2E tests: false

Examples

The following examples demonstrate what triggers this rule and how to fix it.

Invalid

[agents]
max_threads = 4

[features]
multi_agent_v2 = true

Valid

[agents]
max_threads = 4

[features]
# multi_agent_v2 omitted or false