@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.
- package/README.md +73 -51
- package/bin/codex +0 -0
- 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.
|
|
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
|
|
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
|
-
|
|
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
|
|
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
|
|
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.
|
|
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 (
|
|
239
|
-
Codex Version: 0.
|
|
240
|
-
Total Tests:
|
|
241
|
-
โ
Passed:
|
|
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:
|
|
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:
|
|
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.
|
|
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.
|
|
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.
|
|
4
|
-
"description": "OpenAI Codex CLI v0.
|
|
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": {
|