Support iOS ARM64 as a Codex CLI platform
Nobody has claimed this yet.
- Dominant language
- Rust
- Stars
- 125k
- Forks
- 19.4k
- PR merge metrics
- PR metrics pending
Description
What variant of Codex are you using?
CLI
What feature would you like to see?
Feature request: Support iOS ARM64
It would be great if Codex CLI could support ios on ARM64 devices.
Environment
- Device: iPhone 6s Plus
- OS: iOS 15.8.8
- Architecture: arm64
- Jailbreak: Dopamine
- Node.js: v22.19.0
- npm: 10.9.3
- Codex: latest npm release
Current behavior
Codex can be installed successfully:
npm install -g @openai/codex
However, running codex results in:
Error: Unsupported platform: ios (arm64)
The npm package itself installs correctly, but the CLI rejects the platform during startup.
Expected behavior
It would be nice if Codex could recognize:
platform: ios
arch: arm64
and provide an appropriate native binary or otherwise support running on jailbroken iOS devices.
Additional context
I understand that iOS is not currently listed as a supported platform, and that this may require a separate native build target and additional compatibility work.
Still, considering that modern iOS devices are ARM64 and jailbroken iOS provides a Unix-like environment, official iOS support would be interesting.
Thanks!
Additional information
iPhone6sPlus:~ root# uname -a
Darwin iPhone6sPlus 21.6.0 Darwin Kernel Version 21.6.0: Fri Mar 6 21:01:24 PST 2026; root:xnu-8020.241.44~1/RELEASE_ARM64_S8000 iPhone8,2 arm Darwin
iPhone6sPlus:~ root# node --version
v22.19.0
iPhone6sPlus:~ root# npm --version
10.9.3
iPhone6sPlus:~ root# npm install -g @openai/codex
changed 1 package in 7s
iPhone6sPlus:~ root# codex --version
file:///private/preboot/02D9B28F46F01006A8B9FCF990F37E6114AB8568/dopamine-U3LzKe/procursus/usr/lib/node_modules/@openai/codex/bin/codex.js:71
throw new Error(`Unsupported platform: ${platform} (${arch})`);
^
Error: Unsupported platform: ios (arm64)
at file:///private/preboot/02D9B28F46F01006A8B9FCF990F37E6114AB8568/dopamine-U3LzKe/procursus/usr/lib/node_modules/@openai/codex/bin/codex.js:71:9
at ModuleJob.run (node:internal/modules/esm/module_job:345:25)
at async onImport.tracePromise.__proto__ (node:internal/modules/esm/loader:651:26)
at async asyncRunEntryPointWithESMLoader (node:internal/modules/run_main:117:5)
Node.js v22.19.0
iPhone6sPlus:~ root#
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start at bin/codex.js line 71 and inspect how the CLI detects platforms and architectures before rejecting ios (arm64). Trace how the npm package selects or launches its native binary; done means Codex recognizes jailbroken iOS ARM64 and provides a compatible native binary or supported execution path.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- ios, node.js, rust
- Domain
- cli, mobile-dev, operating-systems
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100