Skip to content

DioNanos/codex-termux

 
 

Repository files navigation

πŸ€– Codex CLI - Termux Edition

Pre-compiled OpenAI Codex for Android Termux (ARM64)

What This Is

Official OpenAI Codex CLI compiled for Android Termux. Since Termux is not officially supported by upstream, we apply minimal patches only for critical compatibility issues.

What We Do:

βœ… Use official OpenAI Codex source (https://github.com/openai/codex) βœ… Compile for ARM64 (Android Termux native) βœ… Apply minimal patches only for Termux-specific issues not addressed upstream βœ… Package as npm for easy installation βœ… Maintain full Apache 2.0 compliance with OpenAI attribution

What We DON'T Do:

❌ NO new features ❌ NO behavior modifications (works exactly like upstream) ❌ NO replacement of official Codex

οΏ½οΏ½ Compatibility Patches

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.

Found an issue? Well-documented bug reports with reproduction steps are welcome! Open an issue.


πŸ“‹ Prerequisites

# Update Termux packages
pkg update && pkg upgrade -y

# Install Node.js
pkg install nodejs-lts -y

# Verify
node --version  # v14+
npm --version   # v6+

Requirements:

  • Android 7+ (Termux)
  • ARM64 architecture
  • Node.js β‰₯ 14.0.0
  • ~50MB storage

πŸ“¦ Installation

Via npm (Recommended)

npm install -g @mmmbuto/codex-cli-termux

Verify Installation

codex --version
# Output: codex-cli 0.53.0

codex login
# Opens browser for authentication

Links:


πŸš€ Usage

Same as official Codex CLI:

# Login to OpenAI
codex login

# Start chat
codex

# Help
codex --help

For full documentation, see OpenAI Codex docs.


πŸ”¨ Building from Source

See BUILDING.md for compilation instructions.


πŸ“ License

This project maintains full compliance with the Apache 2.0 license from OpenAI Codex.

Original work: Copyright OpenAI (https://github.com/openai/codex) Termux port: Minimal patches for Android compatibility

See LICENSE file for details.


πŸ™ Credits

  • OpenAI for the amazing Codex CLI
  • Termux community for Android terminal environment
  • All contributors to upstream Codex project

Version: Based on OpenAI Codex 0.53.0 Platform: Android Termux ARM64 Maintained: Community-driven, not affiliated with OpenAI

About

Lightweight coding agent that runs in your terminal

Resources

License

Contributing

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Rust 96.6%
  • Python 1.7%
  • TypeScript 1.0%
  • PowerShell 0.2%
  • JavaScript 0.2%
  • Shell 0.2%
  • Other 0.1%