agents.max_threads=6 but Codex Desktop runtime is capped at 4
Open 💬 2 comments Opened Jul 14, 2026 by geyanqi
Codex Desktop ignores the configured multi-agent concurrency limit.
Expected:
agents.max_threads = 6, matching the documented default and my explicit configuration.
Actual:
The runtime allocates only 4 concurrency slots, including the root agent.
I fully restarted Codex and created a new task. The problem persists.
Environment:
- Thread ID: 019f6053-ea47-73e0-8633-9bfd4e981ea4
- Codex CLI: 0.144.2
- Desktop build: 150.0.7871.115
- macOS: 15.5.0
- Multi-agent runtime: v2
- Config: ~/.codex/config.toml
- Config value: agents.max_threads = 6
Diagnostics performed:
- No project-level override
- No system-level override
- No MDM override found
- No startup --config override
- Restarting and creating a new task did not resolve it
Please explain why this account/runtime is capped at 4 while the documented default is 6, and restore the expected concurrency.
This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗