codex - 💡(How to fix) Fix Desktop should update or restart remote Codex app-server when version is too old [2 comments, 2 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#20492Fetched 2026-05-01 05:42:38
View on GitHub
Comments
2
Participants
2
Timeline
7
Reactions
0
Timeline (top)
labeled ×4commented ×2unlabeled ×1

Error Message

Today the Desktop shows an error like:

Root Cause

ssh <remote> 'codex --update && codex --version'\n# then restart/kill the stale remote codex app-server process so Desktop reconnects to the new binary\n```\n\nThat is hard to discover, and the user often loses access to active remote sessions until they manually SSH in and know which process/cache to update.\n\n### Expected behavior\n\nCodex Desktop should do one of the following when it detects a remote version mismatch:\n\n1. Show an explicit action such as `Update remote Codex and restart app-server`.\n2. Run the remote update/restart automatically when the remote host is reachable and the user has permission.\n3. If automatic update is intentionally unsafe, provide copy-pasteable commands that update the remote CLI and restart the specific app-server process Desktop is using.\n\nThe flow should distinguish these states clearly:\n\n- installed remote `codex` is too old\n- installed remote `codex` is new enough, but the running app-server process is stale\n- Desktop itself is too old\n- update failed because the remote updater failed\n\n### Why this matters\n\nThis has shown up for remote app users after Desktop updates raised the minimum app-server version. The remote pod/host can be healthy and SSH-reachable, but Desktop becomes unusable until the user manually updates the remote CLI cache and restarts the old app-server.\n\n### Related\n\n- #19300 covers stale remote app-server reuse and diagnostics.\n- This request is specifically for a product-supported update/restart path when Desktop already knows the remote app-server version is below the minimum.

Code Example

Codex on this environment is out of date. Update to 0.128.0 or newer. Current version: 0.126.0-alpha.15

---

ssh <remote> 'codex --update && codex --version'\n# then restart/kill the stale remote codex app-server process so Desktop reconnects to the new binary\n
RAW_BUFFERClick to expand / collapse

Feature request

When Codex Desktop connects to a remote SSH/Brix Codex environment and detects that the remote Codex app-server is below the minimum supported version, it should offer a one-click fix, and ideally handle the fix automatically when safe.

Today the Desktop shows an error like:

Codex on this environment is out of date. Update to 0.128.0 or newer. Current version: 0.126.0-alpha.15

The working manual recovery is:

ssh <remote> 'codex --update && codex --version'\n# then restart/kill the stale remote codex app-server process so Desktop reconnects to the new binary\n```\n\nThat is hard to discover, and the user often loses access to active remote sessions until they manually SSH in and know which process/cache to update.\n\n### Expected behavior\n\nCodex Desktop should do one of the following when it detects a remote version mismatch:\n\n1. Show an explicit action such as `Update remote Codex and restart app-server`.\n2. Run the remote update/restart automatically when the remote host is reachable and the user has permission.\n3. If automatic update is intentionally unsafe, provide copy-pasteable commands that update the remote CLI and restart the specific app-server process Desktop is using.\n\nThe flow should distinguish these states clearly:\n\n- installed remote `codex` is too old\n- installed remote `codex` is new enough, but the running app-server process is stale\n- Desktop itself is too old\n- update failed because the remote updater failed\n\n### Why this matters\n\nThis has shown up for remote app users after Desktop updates raised the minimum app-server version. The remote pod/host can be healthy and SSH-reachable, but Desktop becomes unusable until the user manually updates the remote CLI cache and restarts the old app-server.\n\n### Related\n\n- #19300 covers stale remote app-server reuse and diagnostics.\n- This request is specifically for a product-supported update/restart path when Desktop already knows the remote app-server version is below the minimum.

extent analysis

TL;DR

Implement an automatic update and restart feature in Codex Desktop to handle remote Codex app-server version mismatches.

Guidance

  • Detect the remote Codex app-server version and compare it to the minimum supported version to determine if an update is required.
  • Offer a one-click fix, such as "Update remote Codex and restart app-server", to simplify the update process for users.
  • Consider implementing automatic updates when the remote host is reachable and the user has permission to minimize user intervention.
  • Handle different states clearly, including installed remote codex being too old, running app-server process being stale, Desktop being too old, and update failures due to remote updater failures.

Example

No specific code snippet can be provided without more context, but the update command could be similar to the manual recovery command: ssh <remote> 'codex --update && codex --version'.

Notes

The implementation should consider security and permission aspects when automating updates and restarts, ensuring that the user has the necessary permissions and that the update process is secure.

Recommendation

Apply a workaround by implementing an explicit update action, such as "Update remote Codex and restart app-server", to provide a clear and simple solution for users until a full automatic update feature can be developed.

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 Desktop should update or restart remote Codex app-server when version is too old [2 comments, 2 participants]