Repository name: isnl/codex-macos_x64
Unofficial Intel rebuild automation for the Codex macOS app.
Quick links: Releases | Actions | Upstream Changelog
An unofficial automation toolkit that rebuilds the latest official Codex macOS app from Apple Silicon (arm64) into an Intel (x86_64) DMG, then publishes the artifact to GitHub Releases on a daily schedule.
This repository is intended for users who still need to run the Codex desktop app on Intel Macs.
This project is not affiliated with OpenAI.
The official Codex desktop app is distributed for Apple Silicon, while some users still rely on Intel Macs. This project keeps an Intel-friendly build pipeline available by automatically repackaging each new upstream release into a downloadable x86_64 DMG.
The fastest way to get started is from the latest GitHub Release:
- Download the latest Intel build: Latest Release
- Download the latest release assets list: All Releases
Each release includes:
codex-macos-x64-<version>.dmgcodex-macos-x64-<version>.dmg.sha256
- Download the DMG and its matching
.sha256file from the latest Release. - Verify the checksum:
shasum -a 256 -c codex-macos-x64-<version>.dmg.sha256- Open the DMG and drag
Codex.appintoApplications. - On first launch, right-click the app and choose
Open. - If macOS shows a security warning because this rebuilt app is not notarized by Apple, run:
xattr -dr com.apple.quarantine /Applications/Codex.appThe original upstream signature cannot be reused here. Once the app bundle is modified and repackaged for Intel, the original signature becomes invalid and macOS treats the rebuilt app as a new unsigned distribution unless it is signed and notarized again.
- Downloads the latest upstream Codex macOS DMG for Apple Silicon.
- Rebuilds native modules for
darwin-x64. - Swaps the main Electron binaries and helper apps to Intel-compatible versions.
- Re-signs the rebuilt app with an ad-hoc signature.
- Packages the final app into an Intel DMG.
- Publishes the artifact to GitHub Releases automatically when a new upstream version is detected.
| Item | Status |
|---|---|
| Target platform | macOS Intel (x86_64) |
| Upstream source | Official Codex macOS Apple Silicon DMG |
| Delivery channel | GitHub Releases |
| Signing | Ad-hoc |
| Notarization | Not included |
| Auto-update | Disabled in rebuilt package |
- rebuild-x64.sh: local rebuild script for macOS.
- scripts/resolve-latest-release.mjs: resolves the latest upstream version metadata.
- .github/workflows/build-codex-x64.yml: scheduled GitHub Actions workflow for build and release.
- .gitignore: excludes local DMGs and rebuild artifacts.
The official Codex changelog is a useful human-readable reference:
For automation, this project uses the official Sparkle appcast feed:
Why the appcast feed is used for CI:
- It provides the exact app version and build number.
- It reflects the currently published upstream build.
- It is better suited for machine parsing than the changelog page in automated environments.
The upstream Apple Silicon DMG URL is:
flowchart TD
A[Daily GitHub Actions schedule] --> B[Fetch official appcast metadata]
B --> C{New upstream version?}
C -- No --> D[Exit without rebuilding]
C -- Yes --> E[Download latest Codex.dmg]
E --> F[Run rebuild-x64.sh on macOS runner]
F --> G[Create Intel DMG and SHA-256 checksum]
G --> H[Publish GitHub Release]
The workflow runs every day at 00:00 China Standard Time.
- GitHub Actions uses UTC, so the cron expression is
0 16 * * *. - The workflow checks whether a GitHub Release already exists for the latest upstream version.
- If the Release already exists, the job exits without rebuilding.
- If a new upstream version is available, the workflow downloads the latest DMG, rebuilds the Intel package, generates a checksum, and publishes both files to GitHub Releases.
- Create a GitHub repository named
codex-macos_x64. - Push the contents of this project to
isnl/codex-macos_x64. - Open the repository on GitHub and enable Actions.
- Run the workflow manually once from the Actions tab to verify permissions and the first release.
- After that, let the daily schedule handle future releases.
- Git tag:
v<upstream-version> - Release title:
Codex macOS x64 v<upstream-version> - Artifact:
codex-macos-x64-<upstream-version>.dmg - Checksum:
codex-macos-x64-<upstream-version>.dmg.sha256
Requirements:
- macOS
- Xcode Command Line Tools
- Node.js
pnpm
Run locally:
./rebuild-x64.sh /path/to/Codex.dmgOr place the upstream DMG in the project root as Codex.dmg and run:
./rebuild-x64.shThe rebuilt DMG will be written to:
output/Codex-x64.dmg
No. It is an unofficial repackaging workflow built around the official Codex app.
The rebuilt Intel package is not a standard upstream distribution, so bundled auto-update components are intentionally removed to avoid invalid update behavior.
No. The upstream Codex app is modified during the rebuild process, including binary replacement, native module replacement, signature cleanup, and repackaging. Those changes invalidate the original signature, so the final Intel build must either be distributed as an ad-hoc signed app or be signed and notarized again with a valid Apple Developer identity.
The appcast feed is structured, versioned, and better suited for automation. The changelog page remains useful for humans, but is less reliable as a machine interface.
No. The rebuild process depends on macOS-specific tooling such as hdiutil, codesign, lipo, and ditto, so the workflow runs on GitHub's macOS runners.
- This is an unofficial Intel rebuild.
- The rebuilt app is ad-hoc signed and not notarized.
- Auto-update is intentionally disabled in the rebuilt package.
- The upstream app and related trademarks belong to OpenAI.
- Because the upstream DMG URL is static, version detection is based on appcast metadata rather than the DMG filename.
Special thanks to:
- ry2009/codex-intel-mac for the original community work and inspiration behind this rebuild approach.
- Codex for helping write and refine the rebuild script and project documentation.
This project is released under the MIT License. See LICENSE.