Codex Termux

Native Codex CLI for Termux / Android ARM64. This fork tracks upstream OpenAI Codex main and carries only the Android/Termux compatibility delta needed to package and run it.

Install

Termux (Android ARM64)

pkg update && pkg upgrade -y
pkg install nodejs-lts -y
npm install -g @mmmbuto/codex-cli-termux@latest
codex --version
codex login

Requirements:

• Android 7+ / API 24+
• ARM64 device
• Node.js >= 18

Scope

What this fork does:

• tracks upstream OpenAI Codex closely
• builds native Android ARM64 binaries for Termux
• applies only the compatibility patches upstream does not ship
• publishes GitHub release assets and an npm package for Termux users

What this fork does not do:

• maintain a broad feature fork
• replace upstream Codex
• carry fork-only product features unrelated to Termux compatibility

Current Termux Delta

• browser login uses termux-open-url
• self-update points to DioNanos/codex-termux and @mmmbuto/codex-cli-termux
• packaged wrappers preserve CODEX_SELF_EXE, sanitize LD_LIBRARY_PATH, and bundle libc++_shared.so
• Android binaries are linked with RUNPATH=$ORIGIN
• voice and realtime audio remain disabled in the published Termux package
• Android PTY and lock-handling compatibility patches remain enabled where upstream behavior still breaks on Bionic/Termux
• exec/code-mode is built for Android Termux and routed through the packaged codex-exec binary

Releases and Updates

• Latest GitHub release: releases/latest
• Upstream base: OpenAI Codex rust-v0.134.0, packaged as 0.134.0 for npm latest
• npm package: @mmmbuto/codex-cli-termux
• Legacy @mmmbuto/codex-cli-lts (OpenAI Codex 0.80.x) is archived; current builds live in this package or in @mmmbuto/codex-vl (multi-platform).

Maintainer publish flow:

• land validated changes on develop
• publish the tested npm package to latest
• promote the tested commit to clean GitHub main
• publish the GitHub release from main
• add post-release Termux validation reports after device testing

Documentation

• Changelog
• Patch inventory
• Building from source
• Latest runtime validation report: v0.134.0 Termux device smoke
• Install docs
• Authentication
• Configuration

License

This project remains under the Apache 2.0 license inherited from OpenAI Codex.

• Original work: OpenAI
• Termux port: minimal Android compatibility patches

See LICENSE.