Skip to content

DioNanos/codex-termux

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5,269 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Codex Termux

Native Codex CLI for Termux / Android ARM64.
Latest Termux line built from upstream OpenAI Codex rust-v0.120.0.
The separate multi-platform LTS line remains available as @mmmbuto/codex-cli-lts.

npm termux npm lts latest release

Termux robot

Quick Summary

  • Latest (main) → Termux-focused line published as @mmmbuto/codex-cli-termux
  • LTS (lts) → compatibility-focused line published as @mmmbuto/codex-cli-lts
  • Upstream baserust-v0.120.0
  • Current limitation → voice and realtime audio stay disabled in the Termux latest package

Installation

Termux (Android ARM64)

pkg update && pkg upgrade -y
pkg install nodejs-lts -y

# Latest Termux line
npm install -g @mmmbuto/codex-cli-termux@latest

# Verify
codex --version
codex login

Requirements:

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

Linux and macOS

For non-Termux systems, use the LTS line instead:

npm install -g @mmmbuto/codex-cli-lts
codex --version
codex login

Release Lines

Latest (Termux-only)

  • Native ARM64 Android build for Termux
  • Tracks upstream OpenAI Codex closely
  • Minimal compatibility delta only
  • Fork update checks and release links point to DioNanos/codex-termux

LTS (Multi-platform)

  • Conservative support line for compatibility-focused use
  • Separate npm package: @mmmbuto/codex-cli-lts
  • Linux and macOS remain supported there

What This Fork Does

  • Uses the official OpenAI Codex source as upstream
  • Builds native Android ARM64 binaries for Termux
  • Applies only compatibility patches that upstream does not carry
  • Publishes release artifacts on GitHub and npm for Termux users

What This Fork Does Not Do

  • Maintain a broad feature fork
  • Replace upstream Codex
  • Carry unrelated product behavior changes

Termux Compatibility Notes

Current Termux-specific carry patches include:

  • browser login via termux-open-url
  • launcher hardening for helper re-exec
  • RUNPATH=$ORIGIN on Android ELF binaries
  • fork-specific update channel and release links

Current published limitation:

  • voice and realtime audio remain disabled in the Termux latest package

This keeps the packaged binaries free of Android audio linker dependencies while preserving the rest of the upstream CLI flow.

Releases and Updates

Documentation

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.

About

Lightweight coding agent that runs in your terminal

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors

No contributors

Languages

  • Rust 94.9%
  • Python 2.8%
  • TypeScript 1.4%
  • JavaScript 0.3%
  • Starlark 0.3%
  • Shell 0.1%
  • Other 0.2%