@mmmbuto/codex-cli-termux 0.98.0-termux โ†’ 0.99.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 (4) hide show
  1. package/README.md +81 -90
  2. package/bin/codex +0 -0
  3. package/bin/codex-exec +0 -0
  4. package/package.json +2 -2
package/README.md CHANGED
@@ -1,169 +1,160 @@
1
- # ๐Ÿค– Codex CLI - Termux Edition
1
+ # @mmmbuto/codex-cli-lts
2
2
 
3
- > **Built from upstream OpenAI Codex source, compiled for Android Termux (ARM64)**
3
+ > **Long-term support line for Linux x64, Android Termux (ARM64), and macOS arm64**
4
4
 
5
- [![npm](https://img.shields.io/npm/v/@mmmbuto/codex-cli-termux?style=flat-square&logo=npm)](https://www.npmjs.org/package/@mmmbuto/codex-cli-termux)
6
- [![downloads](https://img.shields.io/npm/dt/@mmmbuto/codex-cli-termux?style=flat-square)](https://www.npmjs.org/package/@mmmbuto/codex-cli-termux)
5
+ [![npm](https://img.shields.io/npm/v/@mmmbuto/codex-cli-lts?style=flat-square&logo=npm)](https://www.npmjs.org/package/@mmmbuto/codex-cli-lts)
6
+ [![downloads](https://img.shields.io/npm/dt/@mmmbuto/codex-cli-lts?style=flat-square)](https://www.npmjs.org/package/@mmmbuto/codex-cli-lts)
7
7
  [![ko-fi](https://img.shields.io/badge/โ˜•_Support-Ko--fi-FF5E5B?style=flat-square&logo=ko-fi)](https://ko-fi.com/dionanos)
8
8
 
9
9
  ---
10
10
 
11
- ## What This Is
11
+ ## About
12
12
 
13
- Built from upstream OpenAI Codex source, compiled for Android Termux. Since Termux is not officially supported by upstream, we apply minimal patches only for critical compatibility issues.
13
+ LTS (Long-term support) release line based on upstream OpenAI Codex rust-v0.80.0. This version focuses on stability and /chat compatibility with minimal features and security patches.
14
14
 
15
- ### Termux Edition (0.98.0)
15
+ ### Supported Platforms
16
16
 
17
- This repo maintains **two release lines**:
17
+ - Linux x64
18
+ - Android Termux (ARM64)
19
+ - macOS arm64 (via npm)
18
20
 
19
- - **Latest (main)**: Termux-only, tracks upstream more closely (current: **v0.98.0-termux** based on `rust-v0.98.0`).
20
- - **LTS (lts)**: Long-term support based on upstream `rust-v0.80.0`, stable for compatibility.
21
- The LTS line supports **both /chat and /responses** wire APIs, and receives **security and stability backports only**.
21
+ ---
22
+
23
+ ## Project Scope
24
+
25
+ ### LTS (Multi-platform)
26
+ - Based on upstream rust-v0.80.0
27
+ - Supports /chat and /responses wire APIs
28
+ - Minimal features + security patches only
29
+ - Stable for compatibility-focused use cases
22
30
 
23
- ### What We Do:
31
+ ### What We Do
24
32
  โœ… **Use official OpenAI Codex source** (https://github.com/openai/codex)
25
- โœ… **Compile for ARM64** (Android Termux native)
33
+ โœ… **Compile for Linux x64 + ARM64** (Android Termux native)
26
34
  โœ… **Apply minimal patches** only for Termux-specific issues not addressed upstream
27
35
  โœ… **Package as npm** for easy installation
28
36
  โœ… **Maintain full Apache 2.0 compliance** with OpenAI attribution
29
37
 
30
- ### What We DON'T Do:
38
+ ### What We DON'T Do
31
39
  โŒ **NO new features**
32
40
  โŒ **NO behavior modifications** (works exactly like upstream)
33
41
  โŒ **NO replacement** of official Codex
34
42
 
35
- ### ๐Ÿ”ง Compatibility Patches
43
+ ---
44
+
45
+ ## Patches & Updates
36
46
 
37
- We only apply patches for issues that:
47
+ ### LTS Updates
48
+ - Based on rust-v0.80.0 (minimal features + security only)
49
+ - Maintains /chat wire API compatibility
50
+ - Stability-focused for production use
51
+
52
+ ### Latest Patches
53
+ We apply patches for issues that:
38
54
  - **Prevent Codex from working on Termux**
39
55
  - **Are not addressed by upstream** (Termux is not officially supported)
40
56
  - **Are minimal and well-documented**
41
57
 
42
- **Current patches**: See [patches/](../patches/) directory for full documentation.
58
+ **Current patches**: See [../patches/](../patches/) directory for full documentation.
43
59
 
44
60
  Need help debugging upgrade alerts? See
45
- [docs/termux-upgrade-checks.md](../docs/termux-upgrade-checks.md) for known causes
61
+ [../docs/termux-upgrade-checks.md](../docs/termux-upgrade-checks.md) for known causes
46
62
  and fix strategies.
47
63
 
48
64
  **Found an issue?** Well-documented bug reports with reproduction steps are welcome! Open an [issue](https://github.com/DioNanos/codex-termux/issues).
49
65
 
50
66
  ---
51
67
 
52
- ## ๐Ÿ“‹ Prerequisites
68
+ ## ๐Ÿ“ฆ Installation
69
+
70
+ ### Termux (Android ARM64)
53
71
 
54
72
  ```bash
55
- # Update Termux packages
73
+ # Update Termux packages and install Node.js
56
74
  pkg update && pkg upgrade -y
57
-
58
- # Install Node.js
59
75
  pkg install nodejs-lts -y
60
76
 
77
+ # Install LTS
78
+ npm install -g @mmmbuto/codex-cli-lts
79
+
61
80
  # Verify
62
- node --version # v18+ (recommended v22+)
63
- npm --version # v9+
81
+ codex --version
82
+ codex login
64
83
  ```
65
84
 
66
- **Requirements:**
67
- - Android 7+ (Termux)
68
- - ARM64 architecture
69
- - Node.js >=18 (recommended >=22)
70
- - ~50MB storage
85
+ **Requirements:** Android 7+, ARM64, Node.js >=18 (recommended v22+), ~50MB storage
71
86
 
72
87
  ---
73
88
 
74
- ## ๐Ÿ“ฆ Installation
75
-
76
- ### Via npm (Recommended)
89
+ ### Linux (x64)
77
90
 
78
91
  ```bash
79
- npm install -g @mmmbuto/codex-cli-termux
80
- ```
81
-
82
- ### Version policy (LTS vs Latest)
83
-
84
- This repo maintains **two release lines**:
85
-
86
- - **LTS:** `@mmmbuto/codex-cli-lts` - based on upstream `rust-v0.80.0`, stable for long-term compatibility
87
- - **Latest:** `@mmmbuto/codex-cli-termux` - tracks upstream more closely (current: **v0.98.0-termux** based on `rust-v0.98.0`)
88
-
89
- Install a specific version when needed:
92
+ # Install Node.js (example for Debian/Ubuntu)
93
+ sudo apt-get update
94
+ sudo apt-get install -y nodejs npm
90
95
 
91
- ```bash
92
- # LTS (stable, long-term support)
93
- npm install -g @mmmbuto/codex-cli-lts@latest
96
+ # Install LTS
97
+ npm install -g @mmmbuto/codex-cli-lts
94
98
 
95
- # Latest (tracks upstream)
96
- npm install -g @mmmbuto/codex-cli-termux@latest
99
+ # Verify
100
+ codex --version
101
+ codex login
97
102
  ```
98
103
 
99
- Tip: check what npm considers "latest":
104
+ **Requirements:** Linux x64, Node.js >=18 (recommended v22+), ~80MB storage
100
105
 
101
- ```bash
102
- npm view @mmmbuto/codex-cli-termux dist-tags
103
- npm view @mmmbuto/codex-cli-termux versions --json
104
- ```
106
+ ---
105
107
 
106
- ### Verify Installation
108
+ ### macOS (arm64)
107
109
 
108
110
  ```bash
109
- codex --version
110
- # Output: codex-cli 0.98.0
111
+ # Using npm
112
+ npm install -g @mmmbuto/codex-cli-lts
111
113
 
114
+ # Verify
115
+ codex --version
112
116
  codex login
113
- # Opens browser for authentication
114
117
  ```
115
118
 
116
- **Links:**
117
- - npm: https://www.npmjs.org/package/@mmmbuto/codex-cli-termux
118
- - Releases: https://github.com/DioNanos/codex-termux/releases
119
- - Upstream: https://github.com/openai/codex
120
- - Web UI: [NexusCLI](https://github.com/DioNanos/nexuscli) - Optional web interface for Codex/Claude/Gemini
119
+ **Requirements:** macOS arm64, Node.js >=18 (recommended v22+), ~100MB storage
121
120
 
122
121
  ---
123
122
 
124
- ## ๐Ÿš€ Usage
123
+ ## ๐Ÿ“š Documentation
125
124
 
126
- Same as official Codex CLI:
125
+ - [Installation Details](../docs/installation.md)
126
+ - [Testing](../docs/testing.md)
127
+ - [Building from Source](../BUILDING.md)
128
+ - [Test Reports](../test-reports/)
129
+ - [Full Documentation](../docs/)
127
130
 
128
- ```bash
129
- # Login to OpenAI
130
- codex login
131
-
132
- # Start chat
133
- codex
134
-
135
- # Help
136
- codex --help
137
- ```
131
+ ---
138
132
 
139
- For full documentation, see [OpenAI Codex docs](https://developers.openai.com/codex).
133
+ ## ๐Ÿ”ง Project Maintenance
140
134
 
141
- ### Non-Interactive Mode (Automation)
135
+ Community-maintained port enabling AI-powered coding on Android Termux. Activities include ARM64 compilation, upstream synchronization, Termux compatibility patches, and documentation.
142
136
 
143
- ```bash
144
- # Execute a prompt non-interactively
145
- codex "Generate a hello world in Python"
137
+ **Thank you** to all users who have reported issues, provided feedback, and helped improve this project.
146
138
 
147
- # JSON output for tooling integration
148
- codex --json "List files in current directory"
149
- ```
139
+ ---
150
140
 
151
- ## ๐Ÿงช Testing & Validation
141
+ ## ๐Ÿ“ License
152
142
 
153
- **v0.98.0-termux** (pending): run tests after build โ€” report will be added as `CODEX_TEST_REPORT_v0.98.0.md`
143
+ This project maintains full compliance with Apache 2.0 license from OpenAI Codex.
154
144
 
155
- **LTS validation** (2026-02-02): All categories PASS โ€” see [CODEX_TEST_REPORT_v0.80.3-lts_termux.md](../CODEX_TEST_REPORT_v0.80.3-lts_termux.md)
145
+ **Original work**: Copyright OpenAI (https://github.com/openai/codex)
146
+ **Termux port**: Minimal patches for Android compatibility
156
147
 
157
- **LTS Linux** (2026-01-31): 62 tests, 60 passed / 0 failed / 11 skipped โ€” see [CODEX_TEST_REPORT_v0.80.3-lts_linux.md](../CODEX_TEST_REPORT_v0.80.3-lts_linux.md)
148
+ See [../LICENSE](../LICENSE) file for details.
158
149
 
159
150
  ---
160
151
 
161
- ## License
152
+ ## ๐Ÿ™ Credits
162
153
 
163
- See [LICENSE](../LICENSE) file for details.
154
+ - **OpenAI** for the amazing Codex CLI
155
+ - **Termux** community for Android terminal environment
156
+ - All contributors to upstream Codex project
164
157
 
165
158
  ---
166
159
 
167
- **Version**: Based on OpenAI Codex rust-v0.98.0 with Termux compatibility patches
168
- **Platform**: Android Termux ARM64
169
160
  **Maintained**: Community-driven, not affiliated with OpenAI
package/bin/codex CHANGED
Binary file
package/bin/codex-exec CHANGED
Binary file
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@mmmbuto/codex-cli-termux",
3
- "version": "0.98.0-termux",
4
- "description": "OpenAI Codex CLI (upstream rust-v0.98.0) packaged as 0.98.0-termux โ€“ TUI + automation for Android Termux (ARM64). Use 'codex' for TUI, 'codex exec --json' for automation.",
3
+ "version": "0.99.0-termux",
4
+ "description": "OpenAI Codex CLI (upstream rust-v0.99.0) packaged as 0.99.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": {