🚀 Codex Desktop on Windows (Yes, It Actually Works)

Turn the macOS Codex app into a native-feeling Windows experience in minutes.

⚡ Why This Exists

• No waiting for official Windows release
• One launcher, full setup
• Re-runnable and mostly self-healing

🖼 Screenshots

Startup	Live

🎬 Demo

Cursor_giCQLZ2ZHl_40s.mp4

🔥 Quick Start

launch_codex_mac_on_windows.cmd

🧠 What This Script Does (So You Don’t Have To)

1. Installs missing dependencies
2. Extracts Codex from DMG
3. Patches Electron internals for Windows
4. Rebuilds native modules
5. Launches Codex

🛠 If It Breaks, Fix Fast

Crash on startup

del "%TEMP%\codex-electron-win\app\.win-process-patched"
launch_codex_mac_on_windows.cmd

Codex CLI binary not found

npm install -g @openai/codex

Native module issues

del "%TEMP%\codex-electron-win\app\.win-natives-ok"
launch_codex_mac_on_windows.cmd

Terminal not working (node-pty)

Install VS Build Tools 2022 with Desktop development with C++, then rebuild:

del "%TEMP%\codex-electron-win\app\.win-natives-ok"
launch_codex_mac_on_windows.cmd

📦 Repo Map

• launch_codex_mac_on_windows.cmd - main launcher
• guide.md - deep technical details
• images/ - visuals