codex - 💡(How to fix) Fix Codex macOS startup failure: unsupported feature enablement `workspace_dependencies` [6 comments, 5 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#19220Fetched 2026-04-24 05:58:32
View on GitHub
Comments
6
Participants
5
Timeline
15
Reactions
0
Timeline (top)
commented ×6cross-referenced ×6labeled ×3

Root Cause

I cannot provide session id/context window usage because the app never loads a workspace or starts a session. Logs are available under ~/Library/Logs/com.openai.codex/YYYY/MM/DD (redacted).

RAW_BUFFERClick to expand / collapse

What version of the Codex App are you using (From “About Codex” dialog)?

26.422.20832

What subscription do you have?

Pro

What platform is your computer?

Darwin 25.4.0 arm64 arm

What issue are you seeing?

Codex macOS app fails to start after update. Logs repeatedly show:

unsupported feature enablement workspace_dependencies currently supported features are apps, memories, plugins, tool_search, tool_suggest, tool_call_mcp_elicitation

account/read succeeds, but startup fails immediately after trying to enable workspace_dependencies.

Versions:

  • Codex app (About): 26.422.20832
  • Codex bundled CLI: codex-cli 0.124.0-alpha.2
  • Runtime selected in logs: codex-primary-runtime 26.423.10653

Notes:

  • ChatGPT macOS app works
  • ChatGPT web works
  • Killing processes and resetting app cache/state did not resolve

What steps can reproduce the bug?

  1. Update Codex via in-app updater.
  2. Quit Codex.
  3. Launch Codex.

Actual result: Codex fails during startup and logs unsupported feature enablement workspace_dependencies repeatedly. ChatGPT macOS app opens normally.

Minimal repro: just launch Codex.

I cannot provide session id/context window usage because the app never loads a workspace or starts a session. Logs are available under ~/Library/Logs/com.openai.codex/YYYY/MM/DD (redacted).

Relevant log snippet: unsupported feature enablement workspace_dependencies currently supported features are apps, memories, plugins, tool_search, tool_suggest, tool_call_mcp_elicitation

What is the expected behavior?

Codex should launch successfully on macOS, connect to the local host/runtime without errors, and load the workspace selection UI/dashboard.

It should not try to enable unsupported features (workspace_dependencies) unless the runtime supports them.

Additional information

What I already tried:

  • kill Codex/ChatGPT processes
  • cleared caches and app state
  • tried reopening

Codex still fails at startup with the same log message above. ChatGPT app and web continue to work.

(Logs taken from ~/Library/Logs/com.openai.codex/YYYY/MM/DD; redacted local usernames.)

extent analysis

TL;DR

The Codex app fails to start due to an unsupported feature enablement issue with workspace_dependencies, suggesting a potential version compatibility problem between the Codex app and its runtime.

Guidance

  • Verify the compatibility of the Codex app version (26.422.20832) with the bundled CLI version (codex-cli 0.124.0-alpha.2) and the selected runtime version (codex-primary-runtime 26.423.10653) to ensure they support the workspace_dependencies feature.
  • Check the official documentation or release notes for any known issues related to feature support and version compatibility.
  • Consider downgrading the Codex app or runtime to a version known to support the required features, if possible.
  • If the issue persists, provide more detailed logs or error messages for further analysis.

Example

No specific code snippet is applicable in this case, as the issue seems related to version compatibility rather than code syntax.

Notes

The fact that ChatGPT macOS and web apps work normally suggests the issue is specific to the Codex app or its configuration. The problem might be resolved by ensuring all components are updated to compatible versions or by waiting for an update that addresses the compatibility issue.

Recommendation

Apply workaround: Wait for an update or patch that addresses the compatibility issue, as downgrading might not be feasible or could introduce other compatibility problems. This approach allows for a potential fix without altering the current setup, which could lead to further issues.

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