OpenAI Codex CLI (upstream rust-v0.98.0) packaged as 0.98.0-termux โ TUI + automation for Android Termux (ARM64). Use 'codex' for TUI, 'codex exec --json' for automation.
npm install @mmmbuto/codex-cli-termux> Built from upstream OpenAI Codex source, compiled for Android Termux (ARM64)



---
Built from upstream OpenAI Codex source, compiled for Android Termux. Since Termux is not officially supported by upstream, we apply minimal patches only for critical compatibility issues.
This repo maintains two release lines:
- Latest (main): Termux-only, tracks upstream more closely (current: v0.98.0-termux based on rust-v0.98.0).
- LTS (lts): Long-term support based on upstream rust-v0.80.0, stable for compatibility.
The LTS line supports both /chat and /responses wire APIs, and receives security and stability backports only.
We only apply patches for issues that:
- Prevent Codex from working on Termux
- Are not addressed by upstream (Termux is not officially supported)
- Are minimal and well-documented
Current patches: See patches/ directory for full documentation.
Need help debugging upgrade alerts? See
docs/termux-upgrade-checks.md for known causes
and fix strategies.
Found an issue? Well-documented bug reports with reproduction steps are welcome! Open an issue.
---
``bashUpdate Termux packages
pkg update && pkg upgrade -y
Requirements:
- Android 7+ (Termux)
- ARM64 architecture
- Node.js >=18 (recommended >=22)
- ~50MB storage
---
๐ฆ Installation
$3
`bash
npm install -g @mmmbuto/codex-cli-termux
`$3
This repo maintains two release lines:
- LTS:
@mmmbuto/codex-cli-lts - based on upstream rust-v0.80.0, stable for long-term compatibility
- Latest: @mmmbuto/codex-cli-termux - tracks upstream more closely (current: v0.98.0-termux based on rust-v0.98.0)Install a specific version when needed:
`bash
LTS (stable, long-term support)
npm install -g @mmmbuto/codex-cli-lts@latestLatest (tracks upstream)
npm install -g @mmmbuto/codex-cli-termux@latest
`Tip: check what npm considers "latest":
`bash
npm view @mmmbuto/codex-cli-termux dist-tags
npm view @mmmbuto/codex-cli-termux versions --json
`$3
`bash
codex --version
Output: codex-cli 0.98.0
codex login
Opens browser for authentication
`Links:
- npm: https://www.npmjs.org/package/@mmmbuto/codex-cli-termux
- Releases: https://github.com/DioNanos/codex-termux/releases
- Upstream: https://github.com/openai/codex
- Web UI: NexusCLI - Optional web interface for Codex/Claude/Gemini
---
๐ Usage
Same as official Codex CLI:
`bash
Login to OpenAI
codex loginStart chat
codexHelp
codex --help
`For full documentation, see OpenAI Codex docs.
$3
`bash
Execute a prompt non-interactively
codex "Generate a hello world in Python"JSON output for tooling integration
codex --json "List files in current directory"
`๐งช Testing & Validation
v0.98.0-termux (pending): run tests after build โ report will be added as
CODEX_TEST_REPORT_v0.98.0.md`LTS validation (2026-02-02): All categories PASS โ see CODEX_TEST_REPORT_v0.80.3-lts_termux.md
LTS Linux (2026-01-31): 62 tests, 60 passed / 0 failed / 11 skipped โ see CODEX_TEST_REPORT_v0.80.3-lts_linux.md
---
See LICENSE file for details.
---
Version: Based on OpenAI Codex rust-v0.98.0 with Termux compatibility patches
Platform: Android Termux ARM64
Maintained: Community-driven, not affiliated with OpenAI