codex - 💡(How to fix) Fix Codex Desktop: normal file-reference clicks open side pane instead of configured IDE target [1 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#18151Fetched 2026-04-17 08:32:02
View on GitHub
Comments
1
Participants
2
Timeline
4
Reactions
0
Author
Timeline (top)
labeled ×2closed ×1commented ×1

Root Cause

For users working primarily in an IDE, opening code references in the side pane is a regression. The context-menu path proves that Codex still has a valid IDE-opening path; it is just not used by normal clicks.

Fix Action

Fix / Workaround

I investigated a local patch as a workaround. The apparent renderer click branch lives in app.asar and can be altered so the side-pane branch is skipped, but patching the desktop app bundle is not a viable workaround:

So this probably needs a first-party fix or a supported setting rather than users patching the local desktop bundle.

Code Example

Failed to validate block while ending ASAR file stream
RAW_BUFFERClick to expand / collapse

What version of the Codex App are you using?

Codex Desktop 26.409.20454 / build 1462

What platform is your computer?

macOS 26.4.1 (25E253), arm64

What issue are you seeing?

Normal clicks on markdown file references in Codex Desktop open the built-in Codex side pane instead of the configured IDE target.

The right-click/context-menu path still opens the same file reference in the configured IDE correctly. In my case the configured open target is VS Code, and the context-menu action works, but a normal click goes into Codex's side pane.

This makes normal file references much slower to use because every link requires right-clicking/context-menuing instead of a single click.

This looks related to #17526, but the issue here is not only that the side pane misses the referenced line. The bigger problem is that normal click no longer respects the configured IDE-opening behavior/path, while the context menu still does.

What steps can reproduce the bug?

  1. Configure Codex Desktop to open files in an IDE target such as VS Code.
  2. Ask Codex to reference a file path with a line number in a response.
  3. Click the file reference normally.
  4. Observe that Codex opens the built-in side pane.
  5. Right-click the same reference and choose the IDE/open-file action.
  6. Observe that the configured IDE opens the target file correctly.

What is the expected behavior?

Either:

  • Normal file-reference clicks should use the configured IDE target, matching the context-menu path, or
  • Codex Desktop should expose a setting that lets users choose whether normal clicks open the Codex side pane or the configured IDE.

Why this matters

For users working primarily in an IDE, opening code references in the side pane is a regression. The context-menu path proves that Codex still has a valid IDE-opening path; it is just not used by normal clicks.

Additional investigation

I investigated a local patch as a workaround. The apparent renderer click branch lives in app.asar and can be altered so the side-pane branch is skipped, but patching the desktop app bundle is not a viable workaround:

  • Modifying app.asar trips Electron's runtime ASAR validation.
  • Even after recomputing the visible per-file ASAR integrity hash and updating Info.plist, Electron still crashed with:
Failed to validate block while ending ASAR file stream
  • Re-signing the app bundle also creates macOS signing/TCC/keychain issues because the app is no longer signed by OpenAI.

So this probably needs a first-party fix or a supported setting rather than users patching the local desktop bundle.

extent analysis

TL;DR

The issue can be mitigated by using the context-menu path to open file references in the configured IDE target, such as VS Code, until a first-party fix or supported setting is available.

Guidance

  • The problem seems to be related to a change in the click behavior of markdown file references in Codex Desktop, which now opens the built-in side pane instead of the configured IDE target.
  • To verify the issue, follow the steps provided in the problem description, which involve configuring Codex Desktop to open files in an IDE target and then clicking on a file reference normally and via the context menu.
  • As a temporary workaround, users can use the context-menu path to open file references in the configured IDE target, as this path still respects the configured IDE-opening behavior.
  • It is recommended to monitor the issue tracker, specifically #17526, for any updates or fixes related to this problem.

Example

No code snippet is provided as the issue does not require a code-based solution, but rather a configuration or first-party fix.

Notes

The issue is specific to Codex Desktop version 26.409.20454 and macOS 26.4.1 (25E253), arm64, and may not apply to other versions or platforms. Modifying the app.asar file is not a viable workaround due to Electron's runtime ASAR validation and macOS signing issues.

Recommendation

Apply the workaround of using the context-menu path to open file references in the configured IDE target until a first-party fix or supported setting is available, as modifying the desktop app bundle is not a viable solution due to validation and signing 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