Codex App Windows ARM64

🌐 English | 한국어

Codex App Windows ARM64 is an unofficial repackaging script for running the official Windows x64 Codex app on Windows on ARM. It takes an installed Microsoft Store Codex package, replaces the runtime and native payloads with ARM64-compatible builds where possible, and produces a locally signed ARM64 MSIX package.

This project is intended to be maintained until OpenAI provides official Windows ARM64 support for the Codex app.

Disclaimer

This project is not affiliated with, endorsed by, sponsored by, or officially supported by OpenAI. It is an independent community tool for local experimentation and compatibility work.

OpenAI, Codex, and ChatGPT are trademarks of OpenAI. All other trademarks are the property of their respective owners.

Requirements

• A Windows on ARM device.
• The official Codex app installed from Microsoft Store as the x64 package, or an official x64 Codex MSIX downloaded from Microsoft Store CDN.
• PowerShell 7 (pwsh) is recommended. Windows PowerShell is used only as a fallback.
• Node.js with node and pnpm available on PATH.
• Windows SDK tools, including makeappx.exe, signtool.exe, and mt.exe.
• tar.exe available on PATH for extracting upstream Linux ARM64 runtime assets.
• Visual Studio C++ desktop build tools with the ARM64 C++ toolchain.
• Internet access for downloading Electron, Node.js, Codex helper binaries, ripgrep, and native module build dependencies.

Quick Install From Release

With Scoop:

scoop bucket add codex-woa https://github.com/airtaxi/codex-app-windows-arm64
scoop install codex-woa

Update normally:

scoop update
scoop update codex-woa

Download the release zip from the GitHub Releases page, extract it, and run:

Install.bat

Close Codex completely before installing. Install.bat runs Install.ps1, checks that the MSIX signer matches the included certificate, imports the local certificate into the trusted certificate store when needed, installs the generated MSIX package, and then enables the Windows Computer Use feature flag for the current user.

To remove the repack, uninstall Codex WoA through Windows Settings. The installer intentionally leaves the local certificate trust and Computer Use feature flag in place. To disable the feature flag manually, run:

[Environment]::SetEnvironmentVariable("CODEX_ELECTRON_ENABLE_WINDOWS_COMPUTER_USE", $null, "User")

Build

Run the build wrapper from this repository:

Build-CodexWoA.bat -SourceMode StoreMsix -Force

-SourceMode StoreMsix downloads the latest official Codex x64 MSIX from the Microsoft Store link, verifies its SHA-1 hash, and uses it as the source package.

-SourceMode Installed uses the official x64 Codex package already installed from Microsoft Store.

-SourceMode StoreLatest does not download an MSIX directly. It opens Microsoft Store so you can install or update Codex officially, then continues by using the installed x64 package.

-SourceMode Msix -SourceMsixPath <path> extracts an official x64 Codex MSIX directly and uses it as the source package.

The default output directory is dist.

Development

The build implementation lives in src\CodexWoA.Build and is grouped by build domain. Build-CodexWoA.ps1 remains the stable command-line entrypoint.

Run the fast parser, analyzer, JavaScript, and unit checks before committing:

.\tests\Run-Checks.ps1 -InstallDependencies

See docs/build-architecture.md for module boundaries and maintenance rules.

Outputs

A successful build creates:

• dist\Codex-WoA_<version>_arm64.msix
• dist\cert\CodexWoA.cer
• dist\Install.ps1
• dist\Install.bat
• dist\build-report.json

The certificate is generated locally when needed and is not committed to the repository.

What The Script Changes

• Rewrites AppxManifest.xml for an ARM64 package identity.
• Replaces the Electron runtime with win32-arm64.
• Replaces bundled Node.js with win-arm64.
• Rebuilds in-process native modules such as better-sqlite3, node-pty, and plugin classic-level for ARM64.
• Disables the native Windows updater for the locally signed package.
• Replaces ARM64 helper executables when upstream ARM64 assets are available.
• Embeds an explicit asInvoker manifest in the Windows sandbox setup helper to prevent UAC installer detection after Codex copies the helper outside the MSIX package.
• Adds and validates an ARM64 WSL Codex runtime source at app\resources\codex and app\resources\codex-resources\bwrap.
• Allows x64 fallback only for separate out-of-process tools where ARM64 replacement is unavailable.

Current Support Status

The package is a best-effort compatibility build for Windows on ARM. Basic app launch, login flow, conversation use, ARM64 node-pty, and ARM64 rg.exe replacement have been validated locally, but this is not a substitute for official OpenAI support.

Reports and pull requests are welcome, especially for native dependency updates, helper binary replacement, packaging validation, and Windows on ARM runtime behavior.

Contributors

Thanks to everyone who has contributed to this project.

License

Codex App Windows ARM64 is licensed under the MIT License.

Author

Created by Howon Lee (airtaxi).

Built with help from OpenAI Codex.