Codex hangs on startup at 'Starting MCP servers (2/3): codex_apps'
Open 💬 1 comment Opened Apr 29, 2026 by majiayu000
Summary
Codex CLI frequently appears frozen at startup on:Starting MCP servers (2/3): codex_apps
Environment
- Codex CLI:
0.125.0 - OS: macOS
26.3 (25D125) - Host: Apple Silicon
- Date observed: 2026-04-29
Repro
- Start
codexin terminal. - Observe startup status line.
- It often stays on
Starting MCP servers (2/3): codex_appsfor a long time (minutes in user sessions).
Expected
Startup should either:
- complete quickly, or
- fail fast with an explicit actionable error (network/auth/backend status) instead of appearing hung.
Actual
The UI appears stuck on codex_apps startup for a long time.
Evidence from local logs
From ~/.codex/log/codex-tui.log:
2026-04-27T07:24:29.633581Z
failed to force-refresh tools for MCP server 'codex_apps' ... MCP startup failed: timed out handshaking with MCP server after 30s
2026-04-28T08:28:02.773239Z
failed to force-refresh tools for MCP server 'codex_apps' ... HTTP request failed ... url (https://chatgpt.com/backend-api/wham/apps)
2026-04-22T07:19:09.903833Z(and multiple similar entries)
failed to force-refresh tools for MCP server 'codex_apps' ... error sending request for url (https://chatgpt.com/backend-api/wham/apps)
Notes
- This looks like connector startup / handshake resilience issue.
- Even when eventual fallback may happen, UX currently resembles a freeze.
Suggested fix
- Add clear startup timeout UX for
codex_appswith visible reason. - Degrade gracefully: continue startup with cached tools and explicit warning banner.
- Include retry backoff with user-visible status (attempt count + elapsed time).
This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗