A fork of OpenAI's Codex CLI with Android/Termux support.
For full upstream documentation, see the official Codex CLI README and docs.
This fork maintains a build of Codex CLI that runs natively on Android via Termux, while keeping the codebase compilable for other platforms. It stays close to upstream through frequent merges.
- Android aarch64 target — CI workflow produces release binaries for
aarch64-linux-android - Android code-mode/V8 — Android builds now include working
code-modeand JS REPL support via prebuiltrusty_v8artifacts - Termux-compatible build script —
build-fork.shworks across macOS, Linux, and Termux - Build optimizations for constrained devices — swap file management, thin LTO, job limits to avoid OOM on device
- Platform-specific fixes — file locking fallback,
SHELLenv handling, voice input deps disabled on Android - Small QOL additions — chatbox placeholder tips toggle, model switch while MCP servers connect, PATH shadow warning
- A mostly-vanilla build of Codex that runs on Termux
- Codebase continues to compile for other platforms
- Can be compiled within Termux on devices with high enough specs (e.g. Galaxy S25)
- Frequent merges of upstream into the fork
- Substantial features not in upstream — this is a platform port, not a feature fork
Grab the latest Android aarch64 binary from Releases, or build from source. Current Android release builds include working code-mode / JS REPL support:
# In Termux
git clone https://github.com/mevanlc/codex.git
cd codex
./codex-rs/scripts/build-fork.sh| Target | CI | Notes |
|---|---|---|
| Android aarch64 | Passing | Release binaries published automatically, including code-mode / JS REPL |
| Other platforms | Failing | Investigating — upstream code-mode changes may need additional gating |
- ~30 original commits on top of upstream
- 13 upstream merges to date
- Tracking upstream actively
Same as upstream — Apache-2.0.