Cross-platform Electron build for OpenAI Codex Desktop App.

# Install dependencies
npm install

# Open the interactive dev menu
npm run menu

An interactive terminal menu covering all common tasks:

# Build for current platform
npm run build

# Build for specific platform
npm run build:mac-x64
npm run build:mac-arm64
npm run build:win-x64
npm run build:linux-x64
npm run build:linux-arm64

# Build all platforms
npm run build:all

# Launch Electron directly (dev mode)
npm run dev

Run automatically before every build (npm run patch):

If you have a newer Codex.dmg, place it in the project root and run:

npm run update-src
# or via the dev menu: 📥 Update source from DMG

This extracts app.asar from the DMG, copies .vite/build, webview, and skills into src/, then re-applies all patches automatically.

Requires: 7-Zip installed (Windows: default install path is detected automatically).

├── src/
│   ├── .vite/build/          # Main process bundle (Electron)
│   └── webview/              # Renderer (Frontend)
├── resources/
│   ├── bin/                  # Platform CLI binaries
│   ├── electron.icns         # App icon (macOS)
│   └── notification.wav      # Sound
├── scripts/
│   ├── dev-menu.js           # Interactive dev menu (npm run menu)
│   ├── start-dev.js          # Dev launcher
│   ├── update-from-dmg.js    # DMG source updater
│   ├── rebuild-native.js     # Native module rebuilder
│   ├── patch-copyright.js
│   ├── patch-i18n.js
│   ├── patch-process-polyfill.js
│   ├── patch-chromium-flags.js
│   └── patch-css-containment.js
├── forge.config.js           # Electron Forge config
└── package.json

GitHub Actions automatically builds on:

• Push to master
• Tag v* → Creates draft release

Ported by KAHME248

• OpenAI Codex - Original Codex CLI (Apache-2.0)
• Cometix Space - @cometix/codex binaries
• Electron Forge - Build toolchain

This project rebuilds the Codex Desktop app for cross-platform distribution. Original Codex CLI by OpenAI is licensed under Apache-2.0.