@mmmbuto/codex-cli-termux 0.57.0-termux → 0.58.1-termux

package/README.md

@@ -1,80 +1,170 @@
-# @mmmbuto/codex-cli-termux
+# 🤖 Codex CLI - Termux Edition
 
-OpenAI Codex CLI v0.57.0 pre-compiled for Android Termux (ARM64)
+> **Pre-compiled OpenAI Codex for Android Termux (ARM64)**
 
-## 🚀 v0.57.0 - Latest Release
+## What This Is
 
-**Synced with upstream OpenAI Codex rust-v0.57.0 (25 commits)**
+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.
 
-### Upstream improvements
-- ⌨️ **TUI Navigation**: CTRL-n / CTRL-p for navigating slash commands, files, history
-- 🔧 **Unified Exec**: Improved safe commands handling, process group timeout fixes
-- 🪟 **WSL Support**: Path normalization for Windows Subsystem for Linux
-- 🚀 **App-server v2**: New Thread/Turn APIs, account endpoints
-- 🧹 **Refactoring**: Terminal cleanup (deprecated flush logic removed)
+### 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
 
-### Termux-specific patches (maintained)
-- ✅ Android auto-update disabled (manual update instructions shown)
-- ✅ `termux-open-url` for browser login (avoids ndk-context crash)
-- ✅ RAM optimizations for 16GB devices (lto=false, codegen-units=16)
-- ✅ Disabled unsupported sandbox on Android (landlock/seccomp)
-- ✅ Preserved LD_* environment variables required by Termux
-- ✅ Fixed shell detection ($SHELL instead of getpwuid)
+### 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/](./patches/) directory for full documentation.
+
+**Found an issue?** Well-documented bug reports with reproduction steps are welcome! Open an [issue](https://github.com/DioNanos/codex-termux/issues).
 
 ---
 
-## Installation
+## 📋 Prerequisites
+
+```bash
+# 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)
 
 ```bash
 npm install -g @mmmbuto/codex-cli-termux
 ```
 
-## Usage
+### Verify Installation
 
 ```bash
-codex --version      # Show version (0.57.0)
-codex login          # Authenticate with OpenAI
-codex                # Start interactive TUI
-codex exec "prompt"  # Non-interactive mode
-codex --help         # Full documentation
+codex --version
+# Output: codex-cli 0.58.0
+
+codex login
+# Opens browser for authentication
 ```
 
-### New in 0.57.0
+**Links:**
+- npm: https://www.npmjs.com/package/@mmmbuto/codex-cli-termux
+- Releases: https://github.com/DioNanos/codex-termux/releases
+- Upstream: https://github.com/openai/codex
+
+---
+
+## 🚀 Usage
+
+Same as official Codex CLI:
 
 ```bash
-# Try new TUI navigation
+# Login to OpenAI
+codex login
+
+# Start chat
 codex
-# Press CTRL-n / CTRL-p to navigate slash commands, files, history
+
+# Help
+codex --help
 ```
 
-## Requirements
+For full documentation, see [OpenAI Codex docs](https://github.com/openai/codex).
 
-- **Platform**: Android with Termux
-- **Architecture**: ARM64
-- **Node.js**: ≥ 14.0.0
-- **Storage**: ~50MB
+---
 
-## Source
+## 🔨 Building from Source
 
-This package contains a pre-compiled binary of [OpenAI Codex](https://github.com/openai/codex) for ARM64 Termux.
+See [BUILDING.md](./BUILDING.md) for compilation instructions.
 
-- **Upstream**: [github.com/openai/codex](https://github.com/openai/codex) (rust-v0.57.0)
-- **Fork**: [github.com/DioNanos/codex-termux](https://github.com/DioNanos/codex-termux)
-- **Changelog**: https://github.com/openai/codex/compare/rust-v0.56.0...rust-v0.57.0
+---
 
-## Compatibility
+## 📝 License
 
-Fully compatible with official OpenAI Codex. Only minimal patches for Android/Termux compatibility. No behavior modifications.
+This project maintains full compliance with the Apache 2.0 license from OpenAI Codex.
 
-## License
+**Original work**: Copyright OpenAI (https://github.com/openai/codex)
+**Termux port**: Minimal patches for Android compatibility
 
-Apache 2.0 - See [LICENSE](https://github.com/DioNanos/codex-termux/blob/main/LICENSE)
+See [LICENSE](./LICENSE) file for details.
 
-**Original work**: Copyright OpenAI
-**Termux port**: Minimal patches for Android compatibility
+---
+
+## 🙏 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.58.0 (includes GPT-5.1 support)
+**Platform**: Android Termux ARM64
+**Maintained**: Community-driven, not affiliated with OpenAI
+
+---
+
+## 📜 Changelog
+
+### v0.58.0-termux (2025-11-13)
+
+Synced with upstream OpenAI Codex rust-v0.58.0 (62 commits)
 
-## Maintainer
+**Major features:**
+- 🤖 **GPT-5.1 Support**: New model family (gpt-5.1-codex, gpt-5.1-codex-mini, gpt-5.1)
+- 🧠 **Adaptive Reasoning**: Configurable effort levels (Low, Medium, High)
+- ⌨️ **Enhanced TUI**: Job control, improved navigation, better model picker
+- 🔧 **Shell Detection**: Centralized command generation for unified exec
+- 📊 **App-server v2**: Thread/Turn APIs improvements
 
-Davide A. Guglielmi <dev@mmmbuto.com>
+**Termux-specific:**
+- ✅ All Android patches preserved and verified working
+- ✅ Browser login fix (termux-open-url)
+- ✅ RAM optimizations (lto=false, codegen-units=16)
+- ✅ Auto-update for @mmmbuto/codex-cli-termux
+
+Full upstream changelog: https://github.com/openai/codex/compare/rust-v0.57.0...rust-v0.58.0
+
+---
+
+### v0.57.0-termux (2025-11-10)
+
+Synced with upstream OpenAI Codex rust-v0.57.0 (25 commits)
+
+**Upstream improvements:**
+- ⌨️ **TUI Navigation**: CTRL-n / CTRL-p for navigating slash commands, files, history
+- 🔧 **Unified Exec**: Improved safe commands handling, process group timeout fixes
+- 🪟 **WSL Support**: Path normalization for Windows Subsystem for Linux
+- 🚀 **App-server v2**: New Thread/Turn APIs, account endpoints
+- 🧹 **Refactoring**: Terminal cleanup (deprecated flush logic removed)
+
+**Termux-specific:**
+- ✅ Android auto-update disabled (manual update instructions shown)
+- ✅ `termux-open-url` for browser login (ndk-context crash fix maintained)
+- ✅ RAM optimizations for 16GB devices (lto=false, codegen-units=16)
 
-**Last updated**: 2025-11-10
+Full upstream changelog: https://github.com/openai/codex/compare/rust-v0.56.0...rust-v0.57.0

package/bin/codex.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+
+import { spawn } from 'child_process';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+const binaryPath = join(__dirname, 'codex');
+
+const child = spawn(binaryPath, process.argv.slice(2), {
+  stdio: 'inherit',
+  env: { ...process.env, CODEX_MANAGED_BY_NPM: '1' }
+});
+
+child.on('exit', (code) => {
+  process.exit(code);
+});

package/package.json

@@ -1,40 +1,45 @@
 {
   "name": "@mmmbuto/codex-cli-termux",
-  "version": "0.57.0-termux",
-  "description": "OpenAI Codex CLI v0.57.0 - Termux build (Android ARM64)",
-  "main": "bin/codex",
+  "version": "0.58.1-termux",
+  "description": "OpenAI Codex CLI v0.58.0 with GPT-5.1 support, pre-compiled for Android Termux (ARM64)",
+  "type": "module",
+  "main": "bin/codex.js",
   "bin": {
-    "codex": "./bin/codex"
-  },
-  "scripts": {
-    "postinstall": "echo '✅ @mmmbuto/codex-cli-termux installed successfully'"
+    "codex": "bin/codex.js"
   },
+  "files": [
+    "bin/codex.js",
+    "bin/codex",
+    "README.md"
+  ],
   "keywords": [
     "codex",
     "openai",
     "termux",
     "android",
     "arm64",
-    "cli"
+    "cli",
+    "ai",
+    "coding-agent"
   ],
-  "author": "Davide A. Guglielmi <dev@mmmbuto.com>",
+  "author": "DioNanos",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/DioNanos/codex-termux.git"
   },
+  "homepage": "https://github.com/DioNanos/codex-termux#readme",
   "bugs": {
     "url": "https://github.com/DioNanos/codex-termux/issues"
   },
-  "homepage": "https://github.com/DioNanos/codex-termux#readme",
+  "engines": {
+    "node": ">=14.0.0"
+  },
   "os": [
-    "linux",
-    "android"
+    "android",
+    "linux"
   ],
   "cpu": [
     "arm64"
-  ],
-  "engines": {
-    "node": ">=14.0.0"
-  }
+  ]
 }