codex - 💡(How to fix) Fix Windows app: official pinned taskbar icon does not restore hidden main window after close-to-background [4 comments, 3 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#17205Fetched 2026-04-10 03:44:00
View on GitHub
Comments
4
Participants
3
Timeline
7
Reactions
0
Timeline (top)
commented ×4labeled ×3

Root Cause

This feels related to the current Windows background/stale-process family, but narrower than the existing reports because the key failure here is:

RAW_BUFFERClick to expand / collapse

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

26.406.3494.0

What subscription do you have?

Pro

What platform is your computer?

Microsoft Windows NT 10.0.26200.0 x64

What issue are you seeing?

On Windows, closing the visible Codex window leaves the app running in the background, but clicking the official pinned taskbar icon does not restore the hidden main window.

The only reliable recovery is to end the Codex processes in Task Manager and cold-start the app again.

I verified this after restoring the taskbar pin to the official packaged app target, so this does not appear to be a bad shortcut/pin configuration.

What steps can reproduce the bug?

  1. Launch Codex from the official pinned taskbar icon.
  2. Confirm the main Codex window is visible.
  3. Close the visible Codex window normally.
  4. Confirm Codex remains alive in the background.
  5. Click the same official pinned taskbar icon again.
  6. Observe that no visible Codex window returns.

What is the expected behavior?

Clicking the official pinned taskbar icon should restore the existing hidden Codex window or otherwise show a visible Codex UI without requiring Task Manager cleanup.

Additional information

  • Package full name: OpenAI.Codex_26.406.3494.0_x64__2p2nqsd0c76g0
  • Package family: OpenAI.Codex_2p2nqsd0c76g0
  • Official pinned shortcut used: C:\Users\Nilhan.dev\AppData\Roaming\Microsoft\Internet Explorer\Quick Launch\User Pinned\TaskBar\Codex.lnk

Fresh local repro evidence:

  • Before close, the main top-level window existed as:
    • handle: 0x290672
    • title: Codex
    • class: Chrome_WidgetWin_1
    • visible: true
  • After close, the same main window handle 0x290672 still existed but visible=false
  • After clicking the official pinned taskbar shortcut, the same main window handle 0x290672 still existed and still had visible=false
  • Visible main window count after taskbar relaunch: 0

So the app is not fully gone; the primary window remains alive but hidden, and the official taskbar relaunch path does not bring it back.

I also checked a few adjacent paths:

  • Launching through shell:AppsFolder\\OpenAI.Codex_2p2nqsd0c76g0!App showed the same behavior
  • Current logs during this repro did not show the cache/router errors from some other Windows launch failures

Local bundle inspection suggests the tray button path explicitly calls window visibility logic, while second-instance relaunch appears to route through deep-link argument handling. That may explain why the hidden window survives but is not restored by a plain relaunch.

This feels related to the current Windows background/stale-process family, but narrower than the existing reports because the key failure here is:

official pinned taskbar icon -> existing hidden main window is not restored

I have a local evidence pack with screenshots and a JSON capture of the window state before close, after close, and after taskbar relaunch if that would help.

extent analysis

TL;DR

The issue can be mitigated by modifying the taskbar shortcut to use a command that explicitly shows the hidden main window or by exploring alternative launch methods that bypass the deep-link argument handling.

Guidance

  • Investigate the shell:AppsFolder\\OpenAI.Codex_2p2nqsd0c76g0!App launch method further to see if it can be modified to restore the hidden window.
  • Check the local bundle inspection findings to understand how the tray button path and second-instance relaunch handle window visibility logic and deep-link arguments.
  • Consider creating a custom shortcut that uses a command to show the hidden main window, potentially using a tool like AutoHotkey or a similar scripting solution.
  • Review the JSON capture of the window state to identify any patterns or clues that could help resolve the issue.

Example

No specific code snippet can be provided without more information about the internal workings of the Codex App, but a potential approach could involve using a scripting tool to simulate a window show event when the taskbar icon is clicked.

Notes

The issue seems to be related to how the Codex App handles window visibility and deep-link arguments on Windows, particularly when launched from the taskbar icon. The provided information suggests that the app's internal logic for managing window state may be the root cause.

Recommendation

Apply a workaround, such as creating a custom shortcut or exploring alternative launch methods, as the issue appears to be related to the app's internal logic and may require a targeted fix from the developers.

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