Codex DMG -> Windows

February 3, 2026 ยท View on GitHub

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 (7z in PATH)
  • If 7-Zip is not installed, the runner will try winget or download a portable copy
  • Codex CLI installed (npm i -g @openai/codex)

Quick Start

  1. Place your DMG in the repo root (default name Codex.dmg).
  2. 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.json to keep ABI compatibility.

License

MIT (For the scripts only)