@mmmbuto/gemini-cli-termux 0.20.3-termux → 0.21.1-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 (7) hide show
  1. package/README.md +59 -11
  2. package/bundle/gemini.js +21995 -23173
  3. package/bundle/policies/discovered.toml +8 -0
  4. package/bundle/policies/read-only.toml +56 -0
  5. package/bundle/policies/write.toml +73 -0
  6. package/bundle/policies/yolo.toml +31 -0
  7. package/package.json +6 -4
package/README.md CHANGED
@@ -1,6 +1,7 @@
1
1
  # 🤖 Gemini CLI – Termux Edition
2
2
 
3
- Android/Termux compatible fork of Google Gemini CLI. Installs cleanly on Termux by skipping native modules and adding clipboard detection for Termux.
3
+ Android/Termux compatible fork of Google Gemini CLI. Installs cleanly on Termux
4
+ by skipping native modules and adding clipboard detection for Termux.
4
5
 
5
6
  [![npm](https://img.shields.io/npm/v/@mmmbuto/gemini-cli-termux?style=flat-square&logo=npm)](https://www.npmjs.com/package/@mmmbuto/gemini-cli-termux)
6
7
  [![downloads](https://img.shields.io/npm/dt/@mmmbuto/gemini-cli-termux?style=flat-square)](https://www.npmjs.com/package/@mmmbuto/gemini-cli-termux)
@@ -13,9 +14,11 @@ Android/Termux compatible fork of Google Gemini CLI. Installs cleanly on Termux
13
14
  Temporary compatibility fork of `google-gemini/gemini-cli` for Android Termux.
14
15
 
15
16
  - Tracks upstream regularly.
16
- - Minimal patches only: Termux clipboard env fix, native modules marked optional.
17
+ - Minimal patches only: Termux clipboard env fix, native modules marked
18
+ optional.
17
19
  - Bundled for ARM64/Android.
18
- - Sunset: once upstream adds Termux support, migrate back to `@google/gemini-cli`.
20
+ - Sunset: once upstream adds Termux support, migrate back to
21
+ `@google/gemini-cli`.
19
22
 
20
23
  ## Installation (Termux)
21
24
 
@@ -24,7 +27,7 @@ pkg update && pkg upgrade -y
24
27
  pkg install nodejs-lts -y
25
28
  npm install -g @mmmbuto/gemini-cli-termux
26
29
 
27
- gemini --version # expected: 0.20.3-termux
30
+ gemini --version # expected: 0.20.1-termux (latest)
28
31
  ```
29
32
 
30
33
  Build from source:
@@ -40,7 +43,8 @@ node bundle/gemini.js --version
40
43
  ## Patches
41
44
 
42
45
  - Clipboardy: sets `TERMUX__PREFIX` from `PREFIX` on Android.
43
- - Native modules (`keytar`, `node-pty`, `tree-sitter-bash`) kept optional; install with `--ignore-optional --ignore-scripts`.
46
+ - Native modules (`keytar`, `node-pty`, `tree-sitter-bash`) kept optional;
47
+ install with `--ignore-optional --ignore-scripts`.
44
48
 
45
49
  ## Known Limitations on Termux
46
50
 
@@ -48,26 +52,70 @@ node bundle/gemini.js --version
48
52
  - No secure keychain → credentials stored in plain config files.
49
53
  - Bash parsing without tree-sitter.
50
54
 
55
+ ## Documentation & Fixes
56
+
57
+ ### 📚 Complete Documentation
58
+
59
+ - **[Test Results](./GEMINI_TEST_v0.21.1.md)** - Comprehensive test report with analysis
60
+ - **[Test Suite](./GEMINI_TEST_SUITE.md)** - Test methodology and checklist
61
+ - **[Patches & Fixes](./docs/patches/)** - Known issues and workarounds
62
+
63
+ ### 🔧 Common Issues & Solutions
64
+
65
+ | Issue | Quick Fix | Documentation |
66
+ |-------|-----------|---------------|
67
+ | node-pty warning | `export NODE_NO_WARNINGS=1` | [Details](./docs/patches/node-pty-warning.md) |
68
+ | CLI syntax (`--json`) | Use `-o json` instead | [Details](./docs/patches/cli-syntax-differences.md) |
69
+ | Hooks commands | Use interactive mode `/hooks` | [Details](./docs/patches/hooks-interactive-only.md) |
70
+
71
+ ### 📝 Quick Reference
72
+
73
+ ```bash
74
+ # Correct usage examples
75
+ gemini -o json "your prompt" # ✅ JSON output
76
+ gemini --output-format json "prompt" # ✅ Also works
77
+ gemini --json "prompt" # ❌ Wrong syntax
78
+
79
+ # Quiet mode (suppress warnings)
80
+ export NODE_NO_WARNINGS=1
81
+ gemini "your prompt"
82
+
83
+ # Hooks management (interactive only)
84
+ gemini # Start interactive mode
85
+ /hooks # Manage hooks
86
+ ```
87
+
88
+ See [docs/patches/README.md](./docs/patches/README.md) for complete solutions.
89
+
51
90
  ## Updating
52
91
 
53
92
  ```bash
54
93
  npm install -g @mmmbuto/gemini-cli-termux@latest
55
94
  ```
56
95
 
96
+ ### Versions
97
+
98
+ - **latest**: 0.21.1-termux (this build)
99
+ - **stable**: 0.21.1-termux
100
+
57
101
  ## Tests
58
102
 
59
- Smoke suite:
103
+ - Suite: [`GEMINI_TEST_SUITE.md`](./GEMINI_TEST_SUITE.md)
104
+ - Latest report: [`GEMINI_TEST_REPORT_v0.21.1.md`](./GEMINI_TEST_REPORT_v0.21.1.md)
105
+ - Total: 37 tests; ✅ Pass: 33; ❌ Fail: 4; ⚠️ Skip: 0 (89%).
106
+ - Known gaps (not implemented): `gemini models list`, `gemini hooks` (x2), `gemini auth status`.
107
+ - Package/Binary: 6/6 pass; Termux-specific: 8/8 pass.
108
+ - Optional native modules (node-pty, keytar, tree-sitter-bash) not built on Termux → warnings expected; CLI remains functional.
60
109
 
61
- ```bash
62
- npm run test:termux
63
- ```
110
+ ## Changelog (Termux)
64
111
 
65
- Checks version, help output, and presence of the Termux clipboard patch inside the bundle.
112
+ - **0.21.1-termux** (latest/stable): upstream main sync; Termux patches retained; bundle export fix for `createInkStdio`; tests pending refresh.
66
113
 
67
114
  ## Upstream Tracking
68
115
 
69
116
  - Upstream: https://github.com/google-gemini/gemini-cli
70
- - Divergent files: `esbuild.config.js`, `docs/TERMUX.md`, `package.json`, `README.md`, `test-gemini/*`
117
+ - Divergent files: `esbuild.config.js`, `docs/TERMUX.md`, `package.json`,
118
+ `README.md`, `test-gemini/*`
71
119
 
72
120
  ## License
73
121