Codex Desktop intermittently enters onboarding after Windows reboot instead of restoring the existing session
Nobody has claimed this yet.
Assessment
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Newbie friendliness
- 45/100
Research direction
Start by tracing the session-restoration and first-run/onboarding-state detection paths for Codex Desktop on Windows, especially recovery after reboot or unclean shutdown. Use the reported version and reboot sequence as context, and inspect available diagnostics if provided. Done means an existing installation does not enter onboarding when durable state remains available, while partial recovery shows a restrained recovery notice.
Written by the indexing model from the issue text.
Description
Description
During a sequence of Windows reboots, Codex Desktop initially recovered normally after each restart. Following a later reboot in the same sequence, however, reopening Codex presented the onboarding flow rather than the normal interface for the existing installation.
The durable state was ultimately still present: existing tasks, workspace files, and persistent context had not been lost. Some lightweight UI/session state was not restored.
Presenting onboarding was especially disconcerting because it suggested that the application might have lost its account, configuration, tasks, or workspace state. Determining that the loss was limited to disposable UI state required an unnecessary manual audit.
The earlier successful recoveries during the same reboot cycle suggest that this is an intermittent session-restoration or onboarding-state detection failure, rather than onboarding being an expected consequence of every unclean restart.
Observed behaviour
- Codex Desktop was already configured and in active use.
- Windows went through a sequence of reboots.
- Codex reopened normally following the earlier reboots.
- Following a later reboot, Codex opened into onboarding rather than the existing user interface.
- Some transient UI/session state was no longer present.
- Durable tasks, workspace files, and persistent context were subsequently found to be intact.
Expected behaviour
For an existing installation after a reboot or unclean shutdown, Codex Desktop should:
- recognize the existing user and installation;
- restore the last usable session state where possible;
- open the normal task interface when durable state remains available; and
- show a restrained recovery notice if some session state could not be restored.
Missing or damaged transient UI state should not cause the application to present first-run onboarding.
Impact
No consequential project data appears to have been lost in this instance. The primary impact was loss of confidence during recovery: onboarding made a minor UI-state restoration failure look like possible account or project loss.
This is particularly problematic for an agentic development tool, where users may have multiple active tasks, local workspaces, approvals, and accumulated context. Recovery UX should clearly distinguish:
- a genuinely new installation;
- a signed-out state;
- unavailable durable state; and
- partial recovery of transient UI state.
Frequency and reproducibility
Observed once following several successful recoveries during the same sequence of Windows reboots.
The failure is therefore intermittent. I do not currently have a deterministic reproduction beyond the reboot or unclean-shutdown condition.
Environment
- Application: Codex Desktop for Windows
- Codex version: 26.715.10079.0
- Operating system: Windows 11 Home, version 25H2
- OS build: 26200.8875
- Installation had previously completed onboarding and was in regular use.
Likely area
Session restoration, first-run/onboarding-state detection, or unclean-shutdown recovery.
Privacy note
I have omitted screenshots, task names, workspace paths, account details, and private project information from this public report. Redacted diagnostic information could be provided privately if there is an appropriate channel.
- Dominant language
- Rust
- Stars
- 125k
- Forks
- 19.5k
- Avg merge
- 1m
- Merged PRs (30d)
- 1k
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from openai/codex
-
enhancement remote
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
-
bug CLI windows-os
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
-
macOS sandbox blocks hw.optional.arm64 sysctl, causing Flutter to misdetect Apple Silicon as x64 Openbug CLI sandbox
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
-
bug CLI TUI
Difficulty 2/5 1-3 hours Newbie friendliness 90/100
-
CLI config enhancement skills
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 86/100
kwakseongjae/auto-hwp#319 ·
-
area:cli bug filter-quality good first issue priority:medium
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
-
Difficulty 1/5 Under an hour Newbie friendliness 72/100
bevyengine/bevy#25861 ·
-
comp-datalake
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
ClickHouse/ClickHouse#121222 ·
-
A-linter
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
oxc-project/oxc#26863 ·