Codex Desktop can enter a permanent startup crash loop after creating a project, hiding local history
Nobody has claimed this yet.
Assessment
- Difficulty
- 5/5
- Estimated time
- Over a week
- Newbie friendliness
- 35/100
- Issue type
- Bug
- Clarity
- Mostly clear
- Activity status
- Quiet
- Tech stack
- rust
- Domain
- desktop, operating-systems
Research direction
The report names no source files, tests, or entry points. Start by reproducing the Windows startup loop after creating a local project and inspect the persisted project-state records under %USERPROFILE%.codex; done means invalid startup state no longer blocks launch while existing task history and configuration remain available.
Written by the indexing model from the issue text.
Description
Summary
Codex Desktop for Windows entered a persistent startup crash loop immediately after creating a new local project. Reinstalling did not fix the problem. Moving %USERPROFILE%\.codex aside allowed the app to start with a fresh profile, but made all previous tasks, conversation history, context, skills, plugins, MCP configuration, and other settings appear lost.
Environment
- Product: Codex Desktop for Windows
- Version observed: 26.721.4979.0
- OS: Windows 11
- Severity: Startup blocker with apparent loss of all local history and configuration
Steps to reproduce
- Open Codex Desktop.
- Create a new local project.
- Codex crashes during or immediately after project creation.
- Relaunch Codex.
- Codex fails again on every launch.
- Reinstall Codex; the startup failure remains.
- Move
%USERPROFILE%\.codexaside. - Codex starts with a fresh profile, but previous local history and configuration no longer appear.
Recovery finding
Database integrity checks passed, indicating that the durable task data was not corrupt. The startup failure appeared to be caused by invalid persisted project/startup state. Removing only the suspect project-state records while retaining the databases, sessions, and configuration restored normal startup and the previous history.
Actual behavior
A bad project/startup-state record can prevent the entire application from launching. Reinstallation does not repair or isolate that state, so users may reasonably believe all tasks and context are permanently lost.
Expected behavior
- Skip or quarantine invalid project records.
- Start in a safe mode when project-state loading fails.
- Keep volatile project-selection/UI state isolated from durable task and session data.
- Snapshot and roll back state before project creation or migration.
- Provide built-in Repair, Reindex, and Restore Backup actions.
- Preserve and detect existing local task data during reinstallation.
- Show actionable recovery information after a startup crash.
Privacy
This report is intentionally anonymized. It contains no account identity, personal filesystem paths, project names, conversation content, source code, tokens, files, or raw logs.
- 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 ·