This repository provides a Windows-only runner that extracts the macOS Codex DMG and runs the Electron app on Windows. It unpacks app.asar, swaps mac-only native modules for Windows builds, and launches the app with a compatible Electron runtime. It does not ship OpenAI binaries or assets; you must supply your own DMG and install the Codex CLI.
Requirements
- Windows 10/11
- Node.js
- 7-Zip (
7zin PATH) - If 7-Zip is not installed, the runner will try
wingetor download a portable copy - Codex CLI installed (
npm i -g @openai/codex)
Quick Start
- Place your DMG in the repo root (default name
Codex.dmg). - Run:
.\scripts\run.ps1
Or explicitly:
.\scripts\run.ps1 -DmgPath .\Codex.dmg
Or use the shortcut launcher:
run.cmd
The script will:
- Extract the DMG to
work/ - Build a Windows-ready app directory
- Auto-detect
codex.exe - Launch Codex
Notes
- This is not an official OpenAI project.
- Do not redistribute OpenAI app binaries or DMG files.
- The Electron version is read from the app's
package.jsonto keep ABI compatibility.
License
MIT (For the scripts only)