You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Dekstop App doesnt pick up codex or allow shim install or repair. #6963
Protection details
darwin
Desktop app
OpenCodex Desktop runs this proxy. Turn on Start at Login in the OpenCodex menu; service and launcher changes stay disabled while the app runs it.
Installed but unhealthy
Background service
Starts at login and restarts the proxy after a crash.
Not installed
Install
Codex launcher shim
Runs ocx ensure when a supported Codex script launcher starts.
Not installed
Install
I have tried command line install, reinstall, uninstall, I have tried homebrew install it doesnt work.
Reproduction
Open Max OCX App
Connectors -> Codex
Protection details
darwin
Desktop app
OpenCodex Desktop runs this proxy. Turn on Start at Login in the OpenCodex menu; service and launcher changes stay disabled while the app runs it.
Installed but unhealthy
Background service
Starts at login and restarts the proxy after a crash.
Not installed
Install
Codex launcher shim
Runs ocx ensure when a supported Codex script launcher starts.
Not installed
Install
Version
most recent
Operating system
Mac OS 27
Provider and model
No response
Logs or error output
Screenshots and supporting files
Protection details
darwin
Desktop app
OpenCodex Desktop runs this proxy. Turn on Start at Login in the OpenCodex menu; service and launcher changes stay disabled while the app runs it.
Installed but unhealthy
Background service
Starts at login and restarts the proxy after a crash.
Not installed
Install
Codex launcher shim
Runs ocx ensure when a supported Codex script launcher starts.
Not installed
Install
Redacted configuration
Checks
I searched existing issues and documentation.
I removed secrets, tokens, account details, request credentials, and personal data.
Thanks for the report. #6980 fixes part of this. Here is what we found and what we still need from you.
What your screen means. "Installed but unhealthy" on the Desktop row is not a broken proxy. OpenCodex Desktop is running the proxy, but Startup safety could not verify its Start at Login registration. While the app runs the proxy, the dashboard deliberately disables the background service and launcher shim installers. A shim launch could otherwise start a second CLI proxy while Desktop is restarting its own.
The Desktop row now says Running · Start at Login not verified. The guidance explains that the tray checkbox only shows that the login item file exists, and that macOS can still block it under System Settings → General → Login Items & Extensions.
Dashboard Install/Repair failed whenever the dashboard was served by a compiled ocx, such as the Desktop app's bundled one or the Linux deb. The installer child got an unknown argument. That is fixed.
ocx codex-shim install now shows the real reason when it refuses an fnm temporary path, instead of "Native Codex launcher not found".
Tracked separately: allowing the shim while Desktop runs the proxy (#6971), the tray checkbox vs launchd state (#6972), and finding Codex when the only install is the Codex desktop app (#6973).
Workarounds for now
Keep the Desktop app and make Start at Login stick. Check it in the OpenCodex menu. If it is already checked, open System Settings → General → Login Items & Extensions and allow OpenCodex.
Or move startup to the CLI: quit OpenCodex, then run ocx codex-shim install (or ocx service install) in Terminal.
Could you answer these? They decide which of the follow-ups is your actual blocker.
OpenCodex version (OpenCodex menu, or /Applications/OpenCodex.app/Contents/MacOS/ocx --version), and where OpenCodex.app is installed.
How Codex is installed, plus the output of which -a codex and codex --version in Terminal: Homebrew, npm/bun global, nvm/fnm/volta/mise, or only the Codex desktop app (ChatGPT.app)?
Where you see "doesn't pick up codex", with the exact message or a screenshot (dashboard page, Codex app, or terminal).
The exact output of ocx codex-shim install when you ran it from Terminal, and which ocx that was (which -a ocx).
Is Start at Login checked in the OpenCodex menu? Please also send the output of ls -l ~/Library/LaunchAgents/OpenCodex.plist and launchctl print-disabled gui/$(id -u) | grep -i opencodex.
Please redact anything personal from command output.
Two pieces of this report are addressed in the 2.84.0 train:
Codex not found when the only install is the Codex app — [Feature][macOS] Discover the Codex desktop app's bundled CLI (ChatGPT.app) as a runtime candidate #6973: on macOS, OpenCodex now also checks the CLI bundled inside the Codex app (/Applications/ChatGPT.app or ~/Applications/ChatGPT.app, current layout Contents/Resources/codex-cli/bin/codex) after every existing candidate, and accepts it only when the bundle identifier is com.openai.codex. A newer app binary never silently replaces a CLI you already use.
The remaining part of this report, installing or repairing the Codex launcher shim from the dashboard while OpenCodex Desktop runs the proxy, is fixed by #7032 (merged into dev as 148cfef, not yet released). The dashboard installer fix and the Desktop Start at Login wording landed earlier in #6980, and ChatGPT.app Codex discovery in #6973. Closing. Please reopen with ocx doctor output if the shim still can't be installed after updating.
Activity
pr-assets: #6963 Startup Desktop row screenshot
lidge-jun commentedon Oct 12, 2026
Thanks for the report. #6980 fixes part of this. Here is what we found and what we still need from you.
What your screen means. "Installed but unhealthy" on the Desktop row is not a broken proxy. OpenCodex Desktop is running the proxy, but Startup safety could not verify its Start at Login registration. While the app runs the proxy, the dashboard deliberately disables the background service and launcher shim installers. A shim launch could otherwise start a second CLI proxy while Desktop is restarting its own.
Fixed in #6980
ocx, such as the Desktop app's bundled one or the Linux deb. The installer child got an unknown argument. That is fixed.ocx codex-shim installnow shows the real reason when it refuses an fnm temporary path, instead of "Native Codex launcher not found".Tracked separately: allowing the shim while Desktop runs the proxy (#6971), the tray checkbox vs launchd state (#6972), and finding Codex when the only install is the Codex desktop app (#6973).
Workarounds for now
ocx codex-shim install(orocx service install) in Terminal.Could you answer these? They decide which of the follow-ups is your actual blocker.
/Applications/OpenCodex.app/Contents/MacOS/ocx --version), and whereOpenCodex.appis installed.which -a codexandcodex --versionin Terminal: Homebrew, npm/bun global, nvm/fnm/volta/mise, or only the Codex desktop app (ChatGPT.app)?ocx codex-shim installwhen you ran it from Terminal, and whichocxthat was (which -a ocx).ls -l ~/Library/LaunchAgents/OpenCodex.plistandlaunchctl print-disabled gui/$(id -u) | grep -i opencodex.Please redact anything personal from command output.
fix(startup): dashboard installer on compiled ocx and clearer Desktop…
feat(codex): discover the Codex app's bundled CLI on macOS (#6973)
feat(codex): discover the Codex app's bundled CLI on macOS (#6973)
feat(codex): discover the Codex app's bundled CLI on macOS (#6973)
lidge-jun commentedon Oct 12, 2026
Two pieces of this report are addressed in the 2.84.0 train:
/Applications/ChatGPT.appor~/Applications/ChatGPT.app, current layoutContents/Resources/codex-cli/bin/codex) after every existing candidate, and accepts it only when the bundle identifier iscom.openai.codex. A newer app binary never silently replaces a CLI you already use.If Codex is still not detected after updating, please share
ocx doctoroutput (it redacts paths).lidge-jun commentedon Oct 13, 2026
The remaining part of this report, installing or repairing the Codex launcher shim from the dashboard while OpenCodex Desktop runs the proxy, is fixed by #7032 (merged into dev as 148cfef, not yet released). The dashboard installer fix and the Desktop Start at Login wording landed earlier in #6980, and ChatGPT.app Codex discovery in #6973. Closing. Please reopen with
ocx doctoroutput if the shim still can't be installed after updating.