codex - 💡(How to fix) Fix Windows Codex app: codex: protocol deep link is passed as Electron app path after update

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…

On Windows, launching Codex through a codex: deep link consistently opens an Electron error dialog. The deep link query string appears to be appended to the Electron app path instead of being handled as a protocol/deep-link argument.

The app was working earlier the same day and started failing suddenly later, likely after an update.

Error Message

On Windows, launching Codex through a codex: deep link consistently opens an Electron error dialog. The deep link query string appears to be appended to the Electron app path instead of being handled as a protocol/deep-link argument. An Electron error dialog appears: Error launching app

Root Cause

On Windows, launching Codex through a codex: deep link consistently opens an Electron error dialog. The deep link query string appears to be appended to the Electron app path instead of being handled as a protocol/deep-link argument.

The app was working earlier the same day and started failing suddenly later, likely after an update.

Code Example

Start-Process 'codex:?type=action&action=0&tag=test'

---

Error launching app

Unable to find Electron app at:
C:\Program Files\WindowsApps\OpenAI.Codex_...\?type=action&action=0&tag=test

Cannot find module:
C:\Program Files\WindowsApps\OpenAI.Codex_...\?type=action&action=0&tag=test

---

Add-AppxPackage -DisableDevelopmentMode -Register "C:\Program Files\WindowsApps\OpenAI.Codex_26.527.3686.0_x64__2p2nqsd0c76g0\AppxManifest.xml"

---

Start-Process 'codex:?type=action&action=0&tag=codex-retest-after-reinstall-check'
RAW_BUFFERClick to expand / collapse

Windows Codex app: codex: protocol deep link is passed as Electron app path after update

Summary

On Windows, launching Codex through a codex: deep link consistently opens an Electron error dialog. The deep link query string appears to be appended to the Electron app path instead of being handled as a protocol/deep-link argument.

The app was working earlier the same day and started failing suddenly later, likely after an update.

Environment

  • OS: Windows
  • Codex package: OpenAI.Codex_26.527.3686.0_x64__2p2nqsd0c76g0
  • Install path: C:\Program Files\WindowsApps\OpenAI.Codex_26.527.3686.0_x64__2p2nqsd0c76g0

Reproduction

From PowerShell:

Start-Process 'codex:?type=action&action=0&tag=test'

This also happens when Codex is launched through notification/action-style entry points that generate similar codex: URLs.

Actual Result

An Electron error dialog appears:

Error launching app

Unable to find Electron app at:
C:\Program Files\WindowsApps\OpenAI.Codex_...\?type=action&action=0&tag=test

Cannot find module:
C:\Program Files\WindowsApps\OpenAI.Codex_...\?type=action&action=0&tag=test

Expected Result

The codex: URL should be handled as a deep-link/protocol argument. The query string should not be appended to the Electron app path.

Troubleshooting Already Tried

  • Windows app repair
  • Windows app reset
  • Re-registering the MSIX package with:
Add-AppxPackage -DisableDevelopmentMode -Register "C:\Program Files\WindowsApps\OpenAI.Codex_26.527.3686.0_x64__2p2nqsd0c76g0\AppxManifest.xml"

The issue still reproduces after triggering:

Start-Process 'codex:?type=action&action=0&tag=codex-retest-after-reinstall-check'

Related Public Issues

Possibly related to Windows desktop/MSIX update issues such as:

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 Windows Codex app: codex: protocol deep link is passed as Electron app path after update