codex - 💡(How to fix) Fix Creating sub-agent hangs on MCP startup [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
openai/codex#19542Fetched 2026-04-26 05:15:29
View on GitHub
Comments
0
Participants
1
Timeline
6
Reactions
2
Author
Participants
Timeline (top)
labeled ×5cross-referenced ×1
RAW_BUFFERClick to expand / collapse

What version of Codex CLI is running?

0.125.0

What subscription do you have?

plus

Which model were you using?

gpt-5.5

What platform is your computer?

win10 x64

What terminal emulator and version are you using (if applicable)?

Windows Terminal PowerShell7

What issue are you seeing?

Today I updated codex to the latest version, but when the main agent creates sub-agents, the sub-agents get stuck during startup on MCP. Every time, the last MCP fails to load. I thought it was an issue with that particular MCP, so I removed it, but the problem persisted—it still gets stuck on the last MCP. This morning, when using the codex app, this issue did not occur; I encountered it while using the CLI.

What steps can reproduce the bug?

Let the main agent (gpt-5.5 xhigh) create sub-agents and specify specific models and levels of reasoning (I created a specified sub-agent configuration toml in the agents folder, specifying that this sub-agent uses gpt-5.4 high; I don't know if this has affected the phenomenon).

What is the expected behavior?

The sub-agent is stuck in the startup state, and the last MCP will remain in the loading state.

Additional information

No response

extent analysis

TL;DR

The issue might be related to the recent update of Codex CLI to version 0.125.0, causing sub-agents to get stuck during startup on MCP.

Guidance

  • Verify if the issue persists when using the same sub-agent configuration with a different model or level of reasoning to isolate the problem.
  • Check if the specified sub-agent configuration toml file is correctly formatted and if the model version (gpt-5.4 high) is compatible with the main agent's model (gpt-5.5 xhigh).
  • Try creating sub-agents without specifying a custom configuration toml file to see if the issue is related to the custom configuration.
  • Compare the behavior between the Codex app and CLI to identify any potential differences in how sub-agents are created or configured.

Notes

The issue might be specific to the combination of the main agent's model, sub-agent's model, and the custom configuration file. Further investigation is needed to determine the root cause.

Recommendation

Apply workaround: Try creating sub-agents without the custom configuration toml file or with a different model version to see if the issue persists. This can help identify if the problem is related to the custom configuration or the model compatibility.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

codex - 💡(How to fix) Fix Creating sub-agent hangs on MCP startup [1 participants]