How muanyan-mjq/codex-desktop-fixer works
Codex Desktop Fixer is a Windows repair utility for the Codex/ChatGPT desktop app, plus two separate configuration-repair tools. Its main workflow is scheduled or manual execution of the guard: inspect the app’s processes and windows, repair qualifying stuck or hidden-window cases, and take over slow runtime extraction when detected. The README documents these behaviors and installer wiring; no source excerpts were available, so internal implementation details beyond those documented are omitted.
Main entry points: codex-guard.ps1 Guard orchestration · install.ps1 Task installation · fix-codex.ps1 Manual repair wrapper · remove-claude-imports.ps1 Import cleanup
Components 20
Desktop Guard
- Guard orchestration
codex-guard.ps1 - Process and window inspection
codex-guard.ps1 - Stuck-instance cleanup
codex-guard.ps1 - Hidden-window rescue
codex-guard.ps1 - Slow-path detection
codex-guard.ps1 - Runtime copy and validation
codex-guard.ps1 - App relaunch
codex-guard.ps1 - Action log
codex-guard.ps1
Installation
- Task installation
install.ps1 - Manual repair wrapper
fix-codex.ps1 - Task removal
uninstall.ps1
Configuration Repair
- Import cleanup
remove-claude-imports.ps1 - GitHub MCP repair
fix-github-mcp.ps1
Other components
- User
- Task Scheduler
- WScript launcher
- Windows process and window APIs
- Codex desktop app
- App runtime files
- User configuration files
Connections 23
- User → Task installation: installs
README.md - Task installation → Task Scheduler: registers task
README.md - Task Scheduler → WScript launcher: launches
README.md - WScript launcher → Guard orchestration: starts
README.md - User → Manual repair wrapper: runs repair
README.md - Manual repair wrapper → Guard orchestration: invokes
README.md - Guard orchestration → Process and window inspection: checks state
README.md - Process and window inspection → Windows process and window APIs: queries
README.md - Process and window inspection → Codex desktop app: examines
README.md - Guard orchestration → Stuck-instance cleanup: cleans qualifying instances
README.md - Guard orchestration → Hidden-window rescue: rescues hidden windows
README.md - Guard orchestration → Slow-path detection: checks staging
README.md - Slow-path detection → App runtime files: reads staging data
README.md - Guard orchestration → Runtime copy and validation: takes over extraction
README.md - Runtime copy and validation → App runtime files: copies and validates
README.md - Guard orchestration → App relaunch: restarts app
README.md - App relaunch → Codex desktop app: starts
README.md - Guard orchestration → Action log: records actions
README.md - User → Import cleanup: runs cleanup
README.md - Import cleanup → User configuration files: removes imports and backs up config
README.md - User → GitHub MCP repair: runs repair
README.md - GitHub MCP repair → User configuration files: updates MCP settings
README.md - User → Task removal: removes installation