@mmmbuto/gemini-cli-termux 0.22.0-termux → 0.22.2-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)
 
@@ -40,17 +42,24 @@ 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
 
@@ -112,8 +121,72 @@ 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.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)