@mmmbuto/codex-cli-termux 0.72.0-termux โ†’ 0.74.0-termux

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +73 -51
  2. package/bin/codex +0 -0
  3. package/package.json +2 -2
package/README.md CHANGED
@@ -65,9 +65,6 @@ npm --version # v6+
65
65
 
66
66
  ## ๐Ÿ“ฆ Installation
67
67
 
68
- > [!WARNING]
69
- > **Deprecated versions:** Versions prior to v0.57.0-termux are no longer maintained. Please upgrade to the latest release.
70
-
71
68
  ### Via npm (Recommended)
72
69
 
73
70
  ```bash
@@ -78,7 +75,7 @@ npm install -g @mmmbuto/codex-cli-termux
78
75
 
79
76
  ```bash
80
77
  codex --version
81
- # Output: codex-cli 0.72.0
78
+ # Output: codex-cli 0.74.0-termux
82
79
 
83
80
  codex login
84
81
  # Opens browser for authentication
@@ -88,6 +85,7 @@ codex login
88
85
  - npm: https://www.npmjs.com/package/@mmmbuto/codex-cli-termux
89
86
  - Releases: https://github.com/DioNanos/codex-termux/releases
90
87
  - Upstream: https://github.com/openai/codex
88
+ - Web UI: [NexusCLI](https://github.com/DioNanos/nexuscli) - Optional web interface for Codex/Claude/Gemini
91
89
 
92
90
  ---
93
91
 
@@ -113,6 +111,9 @@ For full documentation, see [OpenAI Codex docs](https://github.com/openai/codex)
113
111
  The `codex` binary is a multitool that includes the `exec` subcommand for automation and scripting:
114
112
 
115
113
  ```bash
114
+ # Enable web search tool
115
+ codex --search
116
+
116
117
  # Run non-interactively with JSON output
117
118
  codex exec --json "list files in current directory"
118
119
 
@@ -132,38 +133,9 @@ codex exec --json -o output.json "describe this project"
132
133
  - `--skip-git-repo-check` - Run outside git repositories
133
134
  - `-o, --output-last-message` - Save final response to file
134
135
 
135
- ### Execpolicy Quickstart
136
-
137
- Codex can enforce your own rules-based execution policy before it runs shell commands.
138
-
139
- 1. Create a policy directory: `mkdir -p ~/.codex/policy`.
140
- 2. Create one or more `.codexpolicy` files in that folder. Codex automatically loads every `.codexpolicy` file in there on startup.
141
- 3. Write `prefix_rule` entries to describe the commands you want to allow, prompt, or block:
142
-
143
- ```starlark
144
- prefix_rule(
145
- pattern = ["git", ["push", "fetch"]],
146
- decision = "prompt", # allow | prompt | forbidden
147
- match = [["git", "push", "origin", "main"]], # examples that must match
148
- not_match = [["git", "status"]], # examples that must not match
149
- )
150
- ```
151
-
152
- - `pattern` is a list of shell tokens, evaluated from left to right; wrap tokens in a nested list to express alternatives (e.g., match both `push` and `fetch`).
153
- - `decision` sets the severity; Codex picks the strictest decision when multiple rules match (forbidden > prompt > allow).
154
- - `match` and `not_match` act as (optional) unit tests. Codex validates them when it loads your policy, so you get feedback if an example has unexpected behavior.
136
+ ### Execpolicy
155
137
 
156
- In this example rule, if Codex wants to run commands with the prefix `git push` or `git fetch`, it will first ask for user approval.
157
-
158
- Use the `codex execpolicy check` subcommand to preview decisions before you save a rule (see the [`codex-execpolicy` README](./codex-rs/execpolicy/README.md) for syntax details):
159
-
160
- ```shell
161
- codex execpolicy check --policy ~/.codex/policy/default.codexpolicy git push origin main
162
- ```
163
-
164
- Pass multiple `--policy` flags to test how several files combine, and use `--pretty` for formatted JSON output. See the [`codex-rs/execpolicy` README](./codex-rs/execpolicy/README.md) for a more detailed walkthrough of the available syntax.
165
-
166
- ## Note: `execpolicy` commands are still in preview. The API may have breaking changes in the future.
138
+ See the [Execpolicy quickstart](./docs/execpolicy.md) to set up rules that govern what commands Codex can execute.
167
139
 
168
140
  ## ๐Ÿงช Testing & Validation
169
141
 
@@ -174,7 +146,7 @@ This project includes a comprehensive test suite specifically designed for Termu
174
146
  **Test Suite**: [`CODEX_TEST_SUITE.md`](./CODEX_TEST_SUITE.md)
175
147
 
176
148
  **Coverage**:
177
- - โœ… **82 automated tests** across 12 categories
149
+ - โœ… **82 automated tests** across 12 categories (including prep/cleanup)
178
150
  - โœ… **10 Termux-specific tests** validating all 8 compatibility patches
179
151
  - โœ… **8 Package & Binary tests** for npm installation verification
180
152
  - โœ… File operations, shell execution, environment detection
@@ -192,7 +164,7 @@ codex
192
164
  ```
193
165
 
194
166
  Codex will automatically:
195
- 1. Execute all 74 tests sequentially
167
+ 1. Execute all applicable tests sequentially
196
168
  2. Report PASS/FAIL for each test
197
169
  3. Generate a final summary with:
198
170
  - Total passed/failed counts
@@ -224,29 +196,58 @@ Codex will automatically:
224
196
  - โœ… Browser opener availability (Patch #1 validation)
225
197
  - โœ… Architecture detection (aarch64/ARM64)
226
198
 
227
- **Suite size**: 82 tests defined (includes optional/manual). Automated run on Termux executes the 49 applicable tests; all passed.
199
+ **Suite size**: 82 tests defined (includes optional/manual). Automated run on Termux executes 50 applicable tests; last run (2025-12-18) completed with 48 โœ… / 0 โŒ / 2 โš ๏ธ skipped (WebSearch tool absent, git info in non-repo workspace).
228
200
 
229
201
  **Success Criteria**:
230
202
  - All System, Files, Shell, and Termux tests must pass
231
203
  - At least 80% overall pass rate
232
204
  - No critical crashes
233
205
 
234
- **Example Report** (v0.72.0):
206
+ **Example Report** (v0.74.0-termux, 2025-12-18):
235
207
  ```
236
208
  CODEX CLI TEST SUITE - FINAL REPORT
237
209
  ====================================
238
- Platform: Android Termux ARM64 (ROG Phone 3)
239
- Codex Version: 0.72.0
240
- Total Tests: 49
241
- โœ… Passed: 49
210
+ Platform: Android Termux ARM64 (reference device)
211
+ Codex Version: 0.74.0-termux
212
+ Total Tests: 50
213
+ โœ… Passed: 48
242
214
  โŒ Failed: 0
243
- โš ๏ธ Skipped: 0
215
+ โš ๏ธ Skipped: 2 (WebSearch disabled, git info skipped in non-repo workspace)
244
216
 
245
217
  Termux-Specific: 10/10 passed โœ…
246
218
  Package & Binary: 8/8 passed โœ…
247
219
 
248
- VERDICT: โœ… PASS
220
+ VERDICT: โš ๏ธ PASS WITH WARNINGS
249
221
  ```
222
+ - [**Getting started**](./docs/getting-started.md)
223
+ - [CLI usage](./docs/getting-started.md#cli-usage)
224
+ - [Slash Commands](./docs/slash_commands.md)
225
+ - [Running with a prompt as input](./docs/getting-started.md#running-with-a-prompt-as-input)
226
+ - [Example prompts](./docs/getting-started.md#example-prompts)
227
+ - [Custom prompts](./docs/prompts.md)
228
+ - [Memory with AGENTS.md](./docs/getting-started.md#memory-with-agentsmd)
229
+ - [**Configuration**](./docs/config.md)
230
+ - [Example config](./docs/example-config.md)
231
+ - [**Sandbox & approvals**](./docs/sandbox.md)
232
+ - [**Execpolicy quickstart**](./docs/execpolicy.md)
233
+ - [**Authentication**](./docs/authentication.md)
234
+ - [Auth methods](./docs/authentication.md#forcing-a-specific-auth-method-advanced)
235
+ - [Login on a "Headless" machine](./docs/authentication.md#connecting-on-a-headless-machine)
236
+ - **Automating Codex**
237
+ - [GitHub Action](https://github.com/openai/codex-action)
238
+ - [TypeScript SDK](./sdk/typescript/README.md)
239
+ - [Non-interactive mode (`codex exec`)](./docs/exec.md)
240
+ - [**Advanced**](./docs/advanced.md)
241
+ - [Tracing / verbose logging](./docs/advanced.md#tracing--verbose-logging)
242
+ - [Model Context Protocol (MCP)](./docs/advanced.md#model-context-protocol-mcp)
243
+ - [**Zero data retention (ZDR)**](./docs/zdr.md)
244
+ - [**Contributing**](./docs/contributing.md)
245
+ - [**Install & build**](./docs/install.md)
246
+ - [System Requirements](./docs/install.md#system-requirements)
247
+ - [DotSlash](./docs/install.md#dotslash)
248
+ - [Build from source](./docs/install.md#build-from-source)
249
+ - [**FAQ**](./docs/faq.md)
250
+ - [**Open source fund**](./docs/open-source-fund.md)
250
251
 
251
252
  ---
252
253
 
@@ -292,7 +293,7 @@ See [LICENSE](./LICENSE) file for details.
292
293
 
293
294
  ---
294
295
 
295
- **Version**: Based on OpenAI Codex 0.72.0 (adds OTEL tracing + config loader refresh)
296
+ **Version**: Based on OpenAI Codex 0.74.0 (Termux build refresh, package/bin verification updated)
296
297
  **Platform**: Android Termux ARM64
297
298
  **Maintained**: Community-driven, not affiliated with OpenAI
298
299
 
@@ -300,14 +301,33 @@ See [LICENSE](./LICENSE) file for details.
300
301
 
301
302
  ## ๐Ÿ“œ Changelog
302
303
 
303
- ### v0.72.0-termux (2025-12-13) โ€“ latest
304
+ ### v0.74.0-termux (2025-12-18) โ€“ latest
304
305
  **Dist-tag**: `latest`
305
306
 
307
+ - โฌ†๏ธ Upstream bump to OpenAI Codex rust-v0.74.0.
308
+ - ๐Ÿงญ Single entrypoint confirmed: `codex` with no args opens TUI; `codex <prompt>` routes to exec; `codex-exec` kept as JS wrapper/symlink.
309
+ - ๐Ÿ”ง Termux patches #1โ€“6, #8, #9 revalidated after merge (`verify-patches.sh`).
310
+ - ๐Ÿ“ฆ npm package bumped to 0.74.0-termux; packaged binary includes `codex` plus `codex-exec` symlink/wrapper.
311
+ - โœ… Tests: CODEX_TEST_SUITE v1.2 on Termux (2025-12-18) โ†’ 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.
312
+
313
+ ### v0.73.0-termux (2025-12-16)
314
+ **Dist-tag**: `latest`
315
+
316
+ - โฌ†๏ธ Upstream bump to OpenAI Codex rust-v0.73.0 (skills manager rework, ghost snapshots v2, config ghost commits, wrap algorithm now FirstFit, OTEL tracing).
317
+ - ๐Ÿงญ Single entrypoint confirmed: `codex` with no args opens TUI; `codex <prompt>` routes to exec; `codex-exec` kept as alias wrapper.
318
+ - ๐Ÿ”ง Termux patches #1โ€“6, #8, #9 revalidated after merge (verify-patches.sh).
319
+ - ๐Ÿ“ฆ npm package bumped to 0.73.0-termux; binary rebuilt and packaged once with symlinked `codex-exec`.
320
+ - โœ… Build: `cargo build -p codex-cli --release --locked` on Termux; npm wrapper binary updated. Install + test suite run still pending.
321
+
322
+
323
+ ### v0.72.0-termux (2025-12-13) โ€“ stable
324
+ **Dist-tag**: `stable`
325
+
306
326
  - โฌ†๏ธ Upstream bump to OpenAI Codex rust-v0.72.0 (OTEL tracing, config loader rewrite, notifications).
307
- - ๐Ÿงญ Single entrypoint: `codex` with no args opens TUI; `codex <prompt>` routes to exec; `codex-exec` kept as alias wrapper.
327
+ - ๐Ÿงญ Single entrypoint confirmed: `codex` with no args opens TUI; `codex <prompt>` routes to exec; `codex-exec` kept as alias wrapper.
308
328
  - ๐Ÿ”ง Termux patches #1โ€“6, #8, #9 revalidated after merge (verify-patches.sh).
309
329
  - ๐Ÿ“ฆ npm package bumped to 0.72.0-termux; binary packaged once with symlinked `codex-exec`.
310
- - โœ… Tests: build + install on Termux pending (run in this session).
330
+ - โœ… Tests: build + install on Termux pending (will run in this session).
311
331
 
312
332
  ### v0.71.0-termux (2025-12-12) โ€“ stable
313
333
  **Dist-tag**: `stable`
@@ -318,11 +338,13 @@ See [LICENSE](./LICENSE) file for details.
318
338
  - ๐Ÿ“ฆ Package verification: bin includes `codex`, symlinked `codex-exec`, JS wrappers; `LD_LIBRARY_PATH` preserved; termux-open-url login path intact.
319
339
  - โœ… 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.
320
340
 
321
- ---
322
-
323
341
  ### v0.64.1-termux (2025-12-03) โ€“ stable
324
342
  **Dist-tag**: `stable`
325
343
 
326
344
  - Maintenance follow-up to 0.64.0: docs/test report refresh and npm package verification (codex-exec symlink + bin entries).
327
345
  - Base upstream: rust-v0.64.0; Termux patches #1-6, #8, #9 revalidated.
328
346
  - โœ… Tests: CODEX_TEST_SUITE v1.2 โ†’ 47/49 pass (Git optional skipped), Package & Binary 8/8 pass, Termux-Specific 10/10 pass.
347
+
348
+ ---
349
+
350
+ **Testing**: Comprehensive test suite v1.2 with 82 tests (incl. Termux + Package) in [`CODEX_TEST_SUITE.md`](./CODEX_TEST_SUITE.md)
package/bin/codex CHANGED
Binary file
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@mmmbuto/codex-cli-termux",
3
- "version": "0.72.0-termux",
4
- "description": "OpenAI Codex CLI v0.72.0 (gpt-5.2) - Multitool with TUI + automation mode. Pre-compiled for Android Termux (ARM64). Use 'codex' for TUI, 'codex exec --json' for automation.",
3
+ "version": "0.74.0-termux",
4
+ "description": "OpenAI Codex CLI (upstream rust-v0.73.0) packaged as 0.74.0-termux โ€“ TUI + automation for Android Termux (ARM64). Use 'codex' for TUI, 'codex exec --json' for automation.",
5
5
  "type": "module",
6
6
  "main": "bin/codex.js",
7
7
  "bin": {