openai / openai/codex

Support iOS ARM64 as a Codex CLI platform

Open
#43,804 5 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

CLI enhancement
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

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.