@mmmbuto/codex-cli-termux 0.77.0-termux → 0.78.0-termux

package/README.md

@@ -31,11 +31,11 @@ We only apply patches for issues that:
 - **Are not addressed by upstream** (Termux is not officially supported)
 - **Are minimal and well-documented**
 
-**Current patches**: See [patches/](./patches/) directory for full documentation.
+**Current patches**: See [patches/](../patches/) directory for full documentation.
 
-Serve aiuto per debuggare gli avvisi di upgrade? Consulta
-[docs/termux-upgrade-checks.md](./docs/termux-upgrade-checks.md) per cause note e
-strategie di fix.
+Need help debugging upgrade alerts? See
+[docs/termux-upgrade-checks.md](../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](https://github.com/DioNanos/codex-termux/issues).
 
@@ -75,7 +75,7 @@ npm install -g @mmmbuto/codex-cli-termux
 
 ```bash
 codex --version
-# Output: codex-cli 0.77.0-termux
+# Output: codex-cli 0.78.0-termux
 
 codex login
 # Opens browser for authentication
@@ -89,6 +89,34 @@ codex login
 
 ---
 
+## ⚡ 2-Minute Quickstart / ⚡ 2分钟快速开始
+Get a first session running fast. Choose the path that matches your account.
+快速完成首次运行。选择与你的账号/网关匹配的路径。
+
+### Path 1 — OpenAI (default)
+```bash
+codex login
+codex
+```
+
+### Path 2 — For friends using OpenRouter / gateways / OpenAI-compatible providers / 给使用 OpenRouter 或兼容网关的朋友
+Set an API key and a minimal config, then run with a profile:
+[docs/openrouter-quickstart.md](../docs/openrouter-quickstart.md)
+
+```bash
+source ~/.codex/.env
+codex --profile or-fast
+```
+
+Caution: model slugs/names can change on providers—verify the current model list first.
+注意：模型名称可能变化，请以提供商模型列表为准。
+
+## 🧭 OpenRouter & gateways note / 🧭 OpenRouter 与兼容网关说明
+This Termux port only adds Android compatibility; it does not change Codex behavior.
+本 Termux 版本仅提供 Android 兼容性，不改变 Codex 行为。
+Providers/models are determined by your own config and backend.
+提供商与模型由你的配置与后端决定。
+
 ## 🚀 Usage
 
 Same as official Codex CLI:
@@ -104,7 +132,7 @@ codex
 codex --help
 ```
 
-For full documentation, see [OpenAI Codex docs](https://github.com/openai/codex).
+For full documentation, see [OpenAI Codex docs](https://developers.openai.com/codex).
 
 ### Non-Interactive Mode (Automation)
 
@@ -135,15 +163,29 @@ codex exec --json -o output.json "describe this project"
 
 ### Execpolicy
 
-See the [Execpolicy quickstart](./docs/execpolicy.md) to set up rules that govern what commands Codex can execute.
+See the [Execpolicy quickstart](../docs/execpolicy.md) to set up rules that govern what commands Codex can execute.
+
+## 🔧 Troubleshooting (Termux) / 🔧 故障排查（Termux）
+Common Termux issues and the fastest places to check.
+常见 Termux 问题与最快排查入口。
+
+- Upgrade alerts or shared library errors: see [docs/termux-upgrade-checks.md](../docs/termux-upgrade-checks.md)
+- Basic usage/setup: see [docs/getting-started.md](../docs/getting-started.md)
+- Authentication/login problems: see [docs/authentication.md](../docs/authentication.md)
+- Still stuck? Open an issue with repro steps: [GitHub Issues](https://github.com/DioNanos/codex-termux/issues)
 
 ## 🧪 Testing & Validation
 
+Latest validation (2026-01-06): 47 passed / 0 failed / 2 skipped — see [CODEX_TEST_SUITE.md](../CODEX_TEST_SUITE.md).
+
+<details>
+<summary>Details: automated test suite, coverage, and sample report</summary>
+
 ### Automated Test Suite
 
 This project includes a comprehensive test suite specifically designed for Termux validation:
 
-**Test Suite**: [`CODEX_TEST_SUITE.md`](./CODEX_TEST_SUITE.md)
+**Test Suite**: [`CODEX_TEST_SUITE.md`](../CODEX_TEST_SUITE.md)
 
 **Coverage**:
 - ✅ **82 automated tests** across 12 categories (including prep/cleanup)
@@ -196,64 +238,62 @@ Codex will automatically:
 - ✅ Browser opener availability (Patch #1 validation)
 - ✅ Architecture detection (aarch64/ARM64)
 
-**Suite size**: 82 tests defined (includes optional/manual). Automated run on Termux executes 50 applicable tests; last run (2025-12-21) completed with 48 ✅ / 0 ❌ / 2 ⚠️ skipped (WebSearch tool absent, git info in non-repo workspace).
+**Suite size**: 82 tests defined (includes optional/manual). Automated run on Termux executes 49 applicable tests; last run (2026-01-06) completed with 47 ✅ / 0 ❌ / 2 ⚠️ skipped (WebSearch unavailable, git info skipped in non-repo workspace).
 
 **Success Criteria**:
 - All System, Files, Shell, and Termux tests must pass
 - At least 80% overall pass rate
 - No critical crashes
 
-**Example Report** (v0.77.0-termux, 2025-12-21):
+**Example Report** (v0.78.0-termux, 2026-01-06):
 ```
 CODEX CLI TEST SUITE - FINAL REPORT
 ====================================
 Platform: Android Termux ARM64 (reference device)
-Codex Version: 0.77.0-termux
-Total Tests: 50
-✅ Passed: 48
+Codex Version: 0.78.0-termux
+Total Tests: 49
+✅ Passed: 47
 ❌ Failed: 0
-⚠️ Skipped: 2 (WebSearch disabled, git info skipped in non-repo workspace)
+⚠️ Skipped: 2 (WebSearch unavailable, git info skipped in non-repo workspace)
 
 Termux-Specific: 10/10 passed ✅
 Package & Binary: 8/8 passed ✅
 
 VERDICT: ✅ PASS
 ```
-- [**Getting started**](./docs/getting-started.md)
-  - [CLI usage](./docs/getting-started.md#cli-usage)
-  - [Slash Commands](./docs/slash_commands.md)
-  - [Running with a prompt as input](./docs/getting-started.md#running-with-a-prompt-as-input)
-  - [Example prompts](./docs/getting-started.md#example-prompts)
-  - [Custom prompts](./docs/prompts.md)
-  - [Memory with AGENTS.md](./docs/getting-started.md#memory-with-agentsmd)
-- [**Configuration**](./docs/config.md)
-  - [Example config](./docs/example-config.md)
-- [**Sandbox & approvals**](./docs/sandbox.md)
-- [**Execpolicy quickstart**](./docs/execpolicy.md)
-- [**Authentication**](./docs/authentication.md)
-  - [Auth methods](./docs/authentication.md#forcing-a-specific-auth-method-advanced)
-  - [Login on a "Headless" machine](./docs/authentication.md#connecting-on-a-headless-machine)
+- [**Getting started**](../docs/getting-started.md)
+  - [CLI usage](../docs/getting-started.md#cli-usage)
+  - [Slash Commands](../docs/slash_commands.md)
+  - [Running with a prompt as input](../docs/getting-started.md#running-with-a-prompt-as-input)
+  - [Example prompts](../docs/getting-started.md#example-prompts)
+  - [Custom prompts](../docs/prompts.md)
+  - [Memory with AGENTS.md](../docs/getting-started.md#memory-with-agentsmd)
+- [**Configuration**](../docs/config.md)
+  - [Example config](../docs/example-config.md)
+- [**Sandbox & approvals**](../docs/sandbox.md)
+- [**Execpolicy quickstart**](../docs/execpolicy.md)
+- [**Authentication**](../docs/authentication.md)
+  - [Auth methods](../docs/authentication.md#forcing-a-specific-auth-method-advanced)
+  - [Login on a "Headless" machine](../docs/authentication.md#connecting-on-a-headless-machine)
 - **Automating Codex**
   - [GitHub Action](https://github.com/openai/codex-action)
-  - [TypeScript SDK](./sdk/typescript/README.md)
-  - [Non-interactive mode (`codex exec`)](./docs/exec.md)
-- [**Advanced**](./docs/advanced.md)
-  - [Tracing / verbose logging](./docs/advanced.md#tracing--verbose-logging)
-  - [Model Context Protocol (MCP)](./docs/advanced.md#model-context-protocol-mcp)
-- [**Zero data retention (ZDR)**](./docs/zdr.md)
-- [**Contributing**](./docs/contributing.md)
-- [**Install & build**](./docs/install.md)
-  - [System Requirements](./docs/install.md#system-requirements)
-  - [DotSlash](./docs/install.md#dotslash)
-  - [Build from source](./docs/install.md#build-from-source)
-- [**FAQ**](./docs/faq.md)
-- [**Open source fund**](./docs/open-source-fund.md)
+  - [TypeScript SDK](../sdk/typescript/README.md)
+  - [Non-interactive mode (`codex exec`)](../docs/exec.md)
+- [**Skills**](../docs/skills.md)
+- [**Installing & building**](../docs/install.md)
+  - [System Requirements](../docs/install.md#system-requirements)
+  - [DotSlash](../docs/install.md#dotslash)
+  - [Build from source](../docs/install.md#build-from-source)
+- [**Contributing**](../docs/contributing.md)
+- [**Open source fund**](../docs/open-source-fund.md)
+
+</details>
 
 ---
 
 ## 🔨 Building from Source
 
-See [BUILDING.md](./BUILDING.md) for compilation instructions.
+See [BUILDING.md](../BUILDING.md) for compilation instructions.
 
 ---
 
@@ -281,7 +321,7 @@ This project maintains full compliance with the Apache 2.0 license from OpenAI C
 **Original work**: Copyright OpenAI (https://github.com/openai/codex)
 **Termux port**: Minimal patches for Android compatibility
 
-See [LICENSE](./LICENSE) file for details.
+See [LICENSE](../LICENSE) file for details.
 
 ---
 
@@ -293,7 +333,7 @@ See [LICENSE](./LICENSE) file for details.
 
 ---
 
-**Version**: Based on OpenAI Codex 0.77.0 (Termux build refresh, package/bin verification updated)
+**Version**: Based on OpenAI Codex main (post rust-v0.78.0) with Termux compatibility patches
 **Platform**: Android Termux ARM64
 **Maintained**: Community-driven, not affiliated with OpenAI
 
@@ -301,57 +341,10 @@ See [LICENSE](./LICENSE) file for details.
 
 ## 📜 Changelog
 
-### v0.77.0-termux (2025-12-21) – latest
-**Dist-tag**: `latest`
-
-- ⬆️ Upstream bump to OpenAI Codex rust-v0.77.0.
-- 🧭 Single entrypoint confirmed: `codex` with no args opens TUI; `codex <prompt>` routes to exec; `codex-exec` kept as JS wrapper (no symlink).
-- 🔧 Termux patches #1–6, #8, #9 revalidated after merge (`verify-patches.sh`).
-- 📦 npm package bumped to 0.77.0-termux; packaged binary includes `codex` plus `codex-exec` wrapper (no symlink).
-- ✅ Tests: CODEX_TEST_SUITE v1.2 on Termux (2025-12-21) → 48 passed / 0 failed / 2 skipped (WebSearch disabled, git info skipped in non-repo workspace); Package & Binary 8/8 passed; Termux-Specific 10/10 passed.
-- 🌟 **Official Upstream Highlights**:
-  - Introducing gpt-5.2-codex our latest frontier model
-  - Projects are now collapsed to a single folder in the file explorer
-  - Hide collapsed folders from the file explorer
-  - Initial support for desktop notifications on macOS and Linux
-  - MCP improvements: Better error handling and resource management
-  - TUI improvements: Better visual feedback and performance
-
-### v0.73.0-termux (2025-12-16)
-**Dist-tag**: `latest`
-
-- ⬆️ Upstream bump to OpenAI Codex rust-v0.73.0 (skills manager rework, ghost snapshots v2, config ghost commits, wrap algorithm now FirstFit, OTEL tracing).
-- 🧭 Single entrypoint confirmed: `codex` with no args opens TUI; `codex <prompt>` routes to exec; `codex-exec` kept as alias wrapper.
-- 🔧 Termux patches #1–6, #8, #9 revalidated after merge (verify-patches.sh).
-- 📦 npm package bumped to 0.73.0-termux; binary rebuilt and packaged once with symlinked `codex-exec`.
-- ✅ Build: `cargo build -p codex-cli --release --locked` on Termux; npm wrapper binary updated. Install + test suite run still pending.
-
-
-### v0.72.0-termux (2025-12-13) – stable
-**Dist-tag**: `stable`
-
-- ⬆️ Upstream bump to OpenAI Codex rust-v0.72.0 (OTEL tracing, config loader rewrite, notifications).
-- 🧭 Single entrypoint confirmed: `codex` with no args opens TUI; `codex <prompt>` routes to exec; `codex-exec` kept as alias wrapper.
-- 🔧 Termux patches #1–6, #8, #9 revalidated after merge (verify-patches.sh).
-- 📦 npm package bumped to 0.72.0-termux; binary packaged once with symlinked `codex-exec`.
-- ✅ Tests: build + install on Termux pending (will run in this session).
-
-### v0.71.0-termux (2025-12-12) – stable
-**Dist-tag**: `stable`
-
-- ⬆️ Upstream bump to OpenAI Codex rust-v0.71.0 (gpt-5.2 models, TUI2 refinements, policy refresh).
-- 🔧 Termux patches #1–6, #8, #9 revalidated; release profile kept RAM-friendly (lto=false, codegen-units=16).
-- 🖥️ Single entrypoint confirmed: `codex` serves both TUI and automation; `codex-exec` remains alias wrapper (JS launcher unchanged).
-- 📦 Package verification: bin includes `codex`, symlinked `codex-exec`, JS wrappers; `LD_LIBRARY_PATH` preserved; termux-open-url login path intact.
-- ✅ Tests: CODEX_TEST_SUITE v1.2 quick run → 37 passed / 0 failed / 12 skipped (web search, AI, some git/Termux-API); critical package checks 8/8.
-
-### v0.64.1-termux (2025-12-03) – stable
-**Dist-tag**: `stable`
-
-- Maintenance follow-up to 0.64.0: docs/test report refresh and npm package verification (codex-exec symlink + bin entries).
-- Base upstream: rust-v0.64.0; Termux patches #1-6, #8, #9 revalidated.
-- ✅ Tests: CODEX_TEST_SUITE v1.2 → 47/49 pass (Git optional skipped), Package & Binary 8/8 pass, Termux-Specific 10/10 pass.
+Upstream Codex releases: https://github.com/openai/codex/releases
+
+Termux-specific changes: see [CHANGELOG.md](../CHANGELOG.md).
 
 ---
 
-**Testing**: Comprehensive test suite v1.2 with 82 tests (incl. Termux + Package) in [`CODEX_TEST_SUITE.md`](./CODEX_TEST_SUITE.md)
+**Testing**: Comprehensive test suite v1.2 with 82 tests (incl. Termux + Package) in [`CODEX_TEST_SUITE.md`](../CODEX_TEST_SUITE.md)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mmmbuto/codex-cli-termux",
-  "version": "0.77.0-termux",
-  "description": "OpenAI Codex CLI (upstream rust-v0.77.0) packaged as 0.77.0-termux – TUI + automation for Android Termux (ARM64). Use 'codex' for TUI, 'codex exec --json' for automation.",
+  "version": "0.78.0-termux",
+  "description": "OpenAI Codex CLI (upstream main, post rust-v0.78.0) packaged as 0.78.0-termux – TUI + automation for Android Termux (ARM64). Use 'codex' for TUI, 'codex exec --json' for automation.",
   "type": "module",
   "main": "bin/codex.js",
   "bin": {
@@ -29,7 +29,7 @@
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
-    "url": "https://github.com/DioNanos/codex-termux.git"
+    "url": "git+https://github.com/DioNanos/codex-termux.git"
   },
   "homepage": "https://github.com/DioNanos/codex-termux#readme",
   "bugs": {