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.

View original on GitHub ↗

This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗