@mmmbuto/gemini-cli-termux 0.21.4-termux → 0.22.1-termux

package/README.md

@@ -1,6 +1,6 @@
 # 🤖 Gemini CLI – Termux Edition
 
-Android/Termux compatible fork of Google Gemini CLI. Installs cleanly on Termux
+Android/Termux optimized fork of Google Gemini CLI. Installs cleanly on Termux
 by skipping native modules and adding clipboard detection for Termux.
 
 [![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)
@@ -11,14 +11,16 @@ by skipping native modules and adding clipboard detection for Termux.
 
 ## What This Is
 
-Temporary compatibility fork of `google-gemini/gemini-cli` for Android Termux.
+**Optimized Termux edition** of `google-gemini/gemini-cli`.
 
-- Tracks upstream regularly.
-- Minimal patches only: Termux clipboard env fix, native modules marked
-  optional, PTY auto-disabled on Termux (fallback to child_process).
-- Bundled for ARM64/Android.
-- Sunset: once upstream adds Termux support, migrate back to
-  `@google/gemini-cli`.
+This project focuses on maintaining a first-class experience for Gemini on
+Android/Termux. It provides critical adaptations for the mobile environment
+while tracking upstream development closely.
+
+- **Termux-First:** Pre-configured for Android filesystem and clipboard.
+- **Lightweight:** Native dependencies managed for ARM64 without complex
+  compilation.
+- **Up-to-Date:** Synchronized with the latest Google Gemini CLI features.
 
 ## Installation (Termux)
 
@@ -27,7 +29,7 @@ pkg update && pkg upgrade -y
 pkg install nodejs-lts -y
 npm install -g @mmmbuto/gemini-cli-termux
 
-gemini --version  # expected: 0.21.4-termux (latest)
+gemini --version  # expected: 0.22.0-termux (latest)
 ```
 
 Build from source:
@@ -40,23 +42,30 @@ npm run build && npm run bundle
 node bundle/gemini.js --version
 ```
 
-## Patches
+## Termux Optimizations
 
-- Clipboardy: sets `TERMUX__PREFIX` from `PREFIX` on Android.
-- Native modules (`keytar`, `node-pty`, `tree-sitter-bash`) kept optional;
-  install with `--ignore-optional --ignore-scripts`.
+- **Smart Clipboard:** Auto-detects Android environment to enable seamless
+  clipboard operations (fixes `TERMUX__PREFIX`).
+- **Streamlined Install:** Native modules (`node-pty`, `keytar`,
+  `tree-sitter-bash`) are handled gracefully to ensure instant installation
+  without compilation errors.
+- **Clean UX:** Suppresses desktop-centric warnings (like home directory checks)
+  to optimize the experience for mobile terminal usage.
+- **ARM64 Native:** Bundled specifically for Android architecture.
 
-## Known Limitations on Termux
+## Environment Specifics
 
-- No PTY (node-pty fails to build) → limited shell integration.
-- No secure keychain → credentials stored in plain config files.
-- Bash parsing without tree-sitter.
+- **Shell Integration:** Uses robust `child_process` fallback instead of
+  `node-pty` for maximum stability on Android.
+- **Credentials:** Keys are stored in standard config files for portability (no
+  dependency on system keychains).
+- **Parser:** Simplified Bash parsing to reduce heavy binary dependencies.
 
 ## Documentation & Fixes
 
 ### 📚 Complete Documentation
 
-- **[Test Results](./GEMINI_TEST_REPORT_v0.21.3.md)** - Comprehensive test
+- **[Test Results](./GEMINI_TEST_REPORT_v0.22.0.md)** - Comprehensive test
   report with analysis
 - **[Test Suite](./GEMINI_TEST_SUITE.md)** - Test methodology and checklist
 - **[Patches & Fixes](./docs/patches/)** - Known issues and workarounds
@@ -96,14 +105,14 @@ npm install -g @mmmbuto/gemini-cli-termux@latest
 
 ### Versions
 
-- **latest**: 0.21.3-termux (this build)
-- **stable**: 0.21.3-termux
+- **latest**: 0.22.0-termux (this build)
+- **stable**: 0.22.0-termux
 
 ## Tests
 
 - Suite: [`GEMINI_TEST_SUITE.md`](./GEMINI_TEST_SUITE.md)
 - Latest report:
-  [`GEMINI_TEST_REPORT_v0.21.3.md`](./GEMINI_TEST_REPORT_v0.21.3.md)
+  [`GEMINI_TEST_REPORT_v0.22.0.md`](./GEMINI_TEST_REPORT_v0.22.0.md)
   - PASS with warnings (node-pty optional missing log; `--version --json`
     outputs plain string; config-path flag unsupported; extensions settings
     needs subcommand).
@@ -112,10 +121,75 @@ npm install -g @mmmbuto/gemini-cli-termux@latest
   - Optional native modules (node-pty, keytar, tree-sitter-bash) not built on
     Termux → warnings expected; CLI remains functional.
 
+## Termux-API Integration (NEW!)
+
+This fork supports optional integration with Termux-API commands for Android
+device access. Enable Gemini to interact with your device hardware and Android
+features.
+
+### Quick Setup
+
+```bash
+# Install Termux-API package
+pkg install termux-api jq
+
+# Copy tool discovery scripts
+mkdir -p ~/.config/gemini/termux-tools
+cp scripts/termux-tools/*.sh ~/.config/gemini/termux-tools/
+
+# Configure in settings
+cat > ~/.config/gemini/settings.json << 'EOF'
+{
+  "tool_discovery_command": "bash ~/.config/gemini/termux-tools/discovery.sh",
+  "tool_call_command": "bash ~/.config/gemini/termux-tools/call.sh"
+}
+EOF
+
+# Test
+gemini "What's my battery status?"
+```
+
+### Supported Commands
+
+Battery, Clipboard, Toast, Notifications, TTS, Vibrate, Torch, WiFi info,
+Location, Camera, Dialog, Share, and more.
+
+See [docs/termux-api/](./docs/termux-api/) for complete documentation.
+
+---
+
+## v0.22.1-termux Improvements
+
+This release includes significant improvements to the Termux experience:
+
+### Installation
+
+- **Clear postinstall message** - No more confusion about native module warnings
+- **`make termux-install`** - One-command build from source
+- **`termux-setup.sh`** - Helper script for first-time setup
+
+### Developer Experience
+
+- **Termux detection utility** - `isTermux()` and `detectTermuxEnvironment()`
+- **Punycode warning suppression** - Cleaner output on Android
+- **Merge-safe patches** - Easy to maintain after upstream sync
+- **`check-termux-patches.sh`** - Verify patches after merge
+
+### Documentation
+
+- Complete Termux-API integration plan
+- 60+ commands documented with parameters
+- Merge strategy guide for maintainers
+
+---
+
 ## Changelog (Termux)
 
-- **0.21.2-termux** (latest/stable): upstream main sync; Termux patches
-  retained; bundle export fix for `createInkStdio`; tests pending refresh.
+- **0.22.1-termux**: Termux-API integration, improved installation UX, Termux
+  detection utility, merge automation scripts.
+- **0.22.0-termux**: Sync with upstream (0.21.0-nightly); added hide banner
+  patch; restored ARM64 dependency.
+- **0.21.4-termux**: (Previous)
 
 ## Upstream Tracking