@mmmbuto/gemini-cli-termux 0.24.5-termux → 0.24.6-termux

package/README.md

@@ -1,7 +1,7 @@
 # 🤖 Gemini CLI – Termux Edition
 
 Android/Termux optimized fork of Google Gemini CLI. Installs cleanly on Termux
-by skipping native modules and adding clipboard detection for Termux.
+with a native ARM64 PTY prebuild and 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)
 [![downloads](https://img.shields.io/npm/dt/@mmmbuto/gemini-cli-termux?style=flat-square)](https://www.npmjs.com/package/@mmmbuto/gemini-cli-termux)
@@ -29,7 +29,7 @@ pkg update && pkg upgrade -y
 pkg install nodejs-lts -y
 npm install -g @mmmbuto/gemini-cli-termux
 
-gemini --version  # expected: 0.24.5-termux (npm latest)
+gemini --version  # expected: 0.24.6-termux (npm latest)
 ```
 
 Build from source:
@@ -37,7 +37,7 @@ Build from source:
 ```bash
 git clone https://github.com/DioNanos/gemini-cli-termux.git
 cd gemini-cli-termux
-npm install --ignore-optional --ignore-scripts
+npm install
 npm run build && npm run bundle
 node bundle/gemini.js --version
 ```
@@ -46,16 +46,16 @@ node bundle/gemini.js --version
 
 - **Smart Clipboard:** Auto-detects Android environment to enable seamless
   clipboard operations (fixes `TERMUX__PREFIX`).
-- **Streamlined Install:** Native PTY/keychain deps are **omitted** on Termux
-  (fallback to `child_process` + file-based tokens), avoiding native builds.
+- **Streamlined Install:** Uses `@mmmbuto/node-pty-android-arm64` prebuild (no
+  node-gyp) and file-based tokens instead of keychain.
 - **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.
 
 ## Environment Specifics
 
-- **Shell Integration:** Uses robust `child_process` fallback instead of
-  `node-pty` for maximum stability on Android.
+- **Shell Integration:** Uses `@mmmbuto/node-pty-android-arm64` on Termux for
+  interactive PTY support (falls back to `child_process` if unavailable).
 - **Credentials:** Keys are stored in standard config files for portability (no
   dependency on system keychains).
 - **Parser:** Simplified Bash parsing to reduce heavy binary dependencies.
@@ -65,8 +65,8 @@ node bundle/gemini.js --version
 ### 📚 Complete Documentation
 
 - **Test Results**
-  - [GEMINI_TEST_REPORT_v0.24.5.md](./GEMINI_TEST_REPORT_v0.24.5.md) — PARTIAL
-    (interactive steps pending; build OK)
+  - [GEMINI_TEST_REPORT_v0.24.6.md](./GEMINI_TEST_REPORT_v0.24.6.md) — PARTIAL
+    (latest report; 0.24.6-termux)
 - **[Test Suite](./GEMINI_TEST_SUITE.md)** - Test methodology and checklist
 - **[Context Memory](./docs/cli/context-memory.md)** - Memory modes, JIT + JSON,
   and setup guide
@@ -76,7 +76,6 @@ node bundle/gemini.js --version
 
 | Issue                 | Quick Fix                     | Documentation                                       |
 | --------------------- | ----------------------------- | --------------------------------------------------- |
-| node-pty warning      | `export NODE_NO_WARNINGS=1`   | [Details](./docs/patches/node-pty-warning.md)       |
 | CLI syntax (`--json`) | Use `-o json` instead         | [Details](./docs/patches/cli-syntax-differences.md) |
 | Hooks commands        | Use interactive mode `/hooks` | [Details](./docs/patches/hooks-interactive-only.md) |
 
@@ -88,10 +87,6 @@ gemini -o json "your prompt"              # ✅ JSON output
 gemini --output-format json "prompt"      # ✅ Also works
 gemini --json "prompt"                    # ❌ Wrong syntax
 
-# Quiet mode (suppress warnings)
-export NODE_NO_WARNINGS=1
-gemini "your prompt"
-
 # Hooks management (interactive only)
 gemini           # Start interactive mode
 /hooks           # Manage hooks
@@ -105,19 +100,19 @@ See [docs/patches/README.md](./docs/patches/README.md) for complete solutions.
 npm install -g @mmmbuto/gemini-cli-termux@latest
 ```
 
-### Changelog (0.24.5-termux)
+### Changelog (0.24.6-termux)
 
-- **Build fix**: MCP SDK typings shim for strict TypeScript builds on Termux.
-- **Auto-update**: Update command uses `@mmmbuto/gemini-cli-termux`.
-- **Docs/tests**: new test report for v0.24.5-termux.
+- **PTY on Termux**: Uses `@mmmbuto/node-pty-android-arm64` prebuild.
+- **Deps cleanup**: Removed `@lydell/node-pty-*` and generic `node-pty`.
+- **Docs**: Updated Termux notes for PTY support.
 
 ## Tests
 
 - Suite: [`GEMINI_TEST_SUITE.md`](./GEMINI_TEST_SUITE.md)
 - Latest report:
-  - [`GEMINI_TEST_REPORT_v0.24.5.md`](./GEMINI_TEST_REPORT_v0.24.5.md) — PARTIAL
-    (interactive steps pending). Notes include non‑interactive tool confirmation
-    limits.
+  - [`GEMINI_TEST_REPORT_v0.24.6.md`](./GEMINI_TEST_REPORT_v0.24.6.md) — PARTIAL
+    (latest report; 0.24.6-termux latest). Notes include non‑interactive tool
+    confirmation limits.
 
 ## Termux-API Integration
 

package/bundle/README.md

@@ -0,0 +1,239 @@
+# 🤖 Gemini CLI – Termux Edition
+
+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)
+[![downloads](https://img.shields.io/npm/dt/@mmmbuto/gemini-cli-termux?style=flat-square)](https://www.npmjs.com/package/@mmmbuto/gemini-cli-termux)
+[![ko-fi](https://img.shields.io/badge/☕_Support-Ko--fi-FF5E5B?style=flat-square&logo=ko-fi)](https://ko-fi.com/dionanos)
+
+---
+
+## What This Is
+
+**Optimized Termux edition** of `google-gemini/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)
+
+```bash
+pkg update && pkg upgrade -y
+pkg install nodejs-lts -y
+npm install -g @mmmbuto/gemini-cli-termux
+
+gemini --version  # expected: 0.22.2-termux (npm latest); 0.22.7-termux available on testing channel
+```
+
+Build from source:
+
+```bash
+git clone https://github.com/DioNanos/gemini-cli-termux.git
+cd gemini-cli-termux
+npm install --ignore-optional --ignore-scripts
+npm run build && npm run bundle
+node bundle/gemini.js --version
+```
+
+## Termux Optimizations
+
+- **Smart Clipboard:** Auto-detects Android environment to enable seamless
+  clipboard operations (fixes `TERMUX__PREFIX`).
+- **Streamlined Install:** Native PTY/keychain deps are **omitted** on Termux
+  (fallback to `child_process` + file-based tokens), avoiding native builds.
+- **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.
+
+## Environment Specifics
+
+- **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.22.7.md](./GEMINI_TEST_REPORT_v0.22.7.md) — testing
+    channel
+  - [GEMINI_TEST_REPORT_v0.22.2.md](./GEMINI_TEST_REPORT_v0.22.2.md) — stable
+    baseline
+- **[Test Suite](./GEMINI_TEST_SUITE.md)** - Test methodology and checklist
+- **[Patches & Fixes](./docs/patches/)** - Known issues and workarounds
+
+### 🔧 Common Issues & Solutions
+
+| Issue                 | Quick Fix                     | Documentation                                       |
+| --------------------- | ----------------------------- | --------------------------------------------------- |
+| node-pty warning      | `export NODE_NO_WARNINGS=1`   | [Details](./docs/patches/node-pty-warning.md)       |
+| CLI syntax (`--json`) | Use `-o json` instead         | [Details](./docs/patches/cli-syntax-differences.md) |
+| Hooks commands        | Use interactive mode `/hooks` | [Details](./docs/patches/hooks-interactive-only.md) |
+
+### 📝 Quick Reference
+
+```bash
+# Correct usage examples
+gemini -o json "your prompt"              # ✅ JSON output
+gemini --output-format json "prompt"      # ✅ Also works
+gemini --json "prompt"                    # ❌ Wrong syntax
+
+# Quiet mode (suppress warnings)
+export NODE_NO_WARNINGS=1
+gemini "your prompt"
+
+# Hooks management (interactive only)
+gemini           # Start interactive mode
+/hooks           # Manage hooks
+```
+
+See [docs/patches/README.md](./docs/patches/README.md) for complete solutions.
+
+## Updating
+
+```bash
+npm install -g @mmmbuto/gemini-cli-termux@latest
+```
+
+### Versions
+
+- **latest / stable**: 0.22.2-termux (default npm dist-tag)
+- **testing**: 0.22.7-termux (adds Gemini 3 Flash preview; install explicitly)
+- **previous**: 0.21.4-termux
+
+## Tests
+
+- Suite: [`GEMINI_TEST_SUITE.md`](./GEMINI_TEST_SUITE.md)
+- Latest reports:
+  - [`GEMINI_TEST_REPORT_v0.22.7.md`](./GEMINI_TEST_REPORT_v0.22.7.md) — testing
+    channel, PASS (static verification) on Termux: version/env, CLI basics,
+    non-interactive JSON, Termux-API, context memory, Gemini 3 Flash, agent TOML
+    loader, patches integrity. Agent shell security filter blocks complex
+    `run_shell_command` calls in this environment (known restriction); CLI
+    itself verified via `--version`.
+  - [`GEMINI_TEST_REPORT_v0.22.2.md`](./GEMINI_TEST_REPORT_v0.22.2.md) — stable
+    baseline, PASS with expected optional-native warnings.
+
+## Termux-API Integration
+
+This fork supports optional integration with Termux-API commands for Android
+device access. Enable Gemini to interact with your device hardware and Android
+features.
+
+## Context memory + TTS note:
+
+- The Termux fork ships JSON context memory at
+  `~/.gemini/context_memory/{base.json,user.json,user.journal.jsonl}`. In
+  `/settings → Context Memory` you can toggle autoload, choose the primary
+  source, and (if needed) enable writes to `base.json` via
+  `Allow Base Memory Writes`.
+- TTS notifications are controlled by
+  `/settings → Notifications → Enable TTS Notifications`. When disabled,
+  `termux-tts-speak` is blocked even if an agent asks for it. These behaviors
+  are merge-safe and confined to Termux patches.
+
+### 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.7-termux (testing) Highlights
+
+- **Gemini 3 Flash preview** enabled (`gemini-3-flash-preview`) with help/docs
+  visibility.
+
+- **Context Memory (default ON)**: strict, merge-safe JSON memory at
+  `~/.gemini/context_memory/{base.json,user.json,user.journal.jsonl}` with
+  per-source autoload, primary selector, and GEMINI.md bootstrap on first run.
+- **Deterministic compaction**: journal append-only with incremental offsets,
+  closed JSON schemas, key-based upsert, TTL/ephemeral guardrails,
+  sensitivity=high excluded from autoload.
+- **Base write toggle**: enable/disable writes to `base.json` from
+  `/save_memory target=base` (off by default, merge-safe).
+- **TTS toggle**: new `/settings` switch to allow/block `termux-tts-speak`;
+  shell tool blocks TTS when disabled.
+- **Termux-first shell**: non-interactive commands (`echo`, `pwd`, `ls`) work
+  without native PTY deps; optional natives removed for faster installs.
+- **Termux-API tools**: discovery/call scripts under `scripts/termux-tools/`
+  expose Termux APIs as tools (battery, tts, camera, etc.).
+
+See `docs/cli/context-memory.md` for the detailed memory layout and settings.
+
+## v0.22.2-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)
+
+## Upstream Tracking
+
+- Upstream: https://github.com/google-gemini/gemini-cli
+- Divergent files: `esbuild.config.js`, `docs/TERMUX.md`, `package.json`,
+  `README.md`, `test-gemini/*`
+
+## License
+
+Apache 2.0 (same as upstream). See LICENSE.

package/bundle/docs/TERMUX.md

@@ -15,36 +15,35 @@ Android.
 npm install -g @mmmbuto/gemini-cli-termux
 
 gemini --version
-# expected: 0.22.0-termux (latest)
+# expected: 0.24.6-termux (latest)
 ```
 
 Features of the npm build
 
 - ARM64/Android bundle included
 - Termux clipboard patch (`PREFIX` -> `TERMUX__PREFIX`)
-- Native modules left optional; no NDK required
+- PTY prebuild via `@mmmbuto/node-pty-android-arm64` (no NDK required)
 
 ## Build from source (Termux fork)
 
 ```bash
 git clone https://github.com/DioNanos/gemini-cli-termux.git
 cd gemini-cli-termux
-npm install --ignore-optional --ignore-scripts
+npm install
 npm run build && npm run bundle
 node bundle/gemini.js --version
 ```
 
 ## Known issues
 
-1. Native modules (keytar, node-pty, tree-sitter-bash) fail on Termux → ignored
-   with the install flags above.
-2. Clipboardy TERMUX\_\_PREFIX is patched in the bundle.
-3. Node punycode warning is harmless; optional:
+1. If the PTY prebuild fails to load, the CLI falls back to `child_process`
+   (non-interactive).
+2. Node punycode warning is harmless; optional:
    `node --no-deprecation bundle/gemini.js`.
 
 ## Limitations
 
-- No full PTY support → some interactive shell features limited
+- PTY support depends on the `@mmmbuto/node-pty-android-arm64` prebuild
 - No secure keychain → credentials stored in plain config files
 - Bash parsing simplified (no tree-sitter)
 
@@ -52,7 +51,7 @@ node bundle/gemini.js --version
 
 - npm: `npm install -g @mmmbuto/gemini-cli-termux@latest`
 - source:
-  `git pull && npm install --ignore-optional --ignore-scripts && npm run build && npm run bundle`
+  `git pull && npm install && npm run build && npm run bundle`
 
 ## Termux-API Support (Optional)
 

package/bundle/docs/patches/MERGE_TO_0.24_ANALYSIS.md

@@ -222,7 +222,7 @@ grep -r "isTermux" packages/cli/src/config/config.ts
 grep "termux-detect" packages/core/src/index.ts
 
 # Build test
-npm install --ignore-optional --ignore-scripts
+npm install
 npm run build
 npm run bundle
 node bundle/gemini.js --version  # deve essere 0.24.0-termux
@@ -289,7 +289,7 @@ Aggiornare versione e sandboxImageUri.
 | ------------------------- | ----------- | -------------------------------------- |
 | Context memory regression | Bassa       | Test completo memory system            |
 | Shell tool breakage       | Bassa       | Verificare isTermux() logic            |
-| Build failure             | Molto bassa | --ignore-optional --ignore-scripts     |
+| Build failure             | Molto bassa | prepare-termux: npm install (no flags) |
 | npm publish issues        | Bassa       | Verificare files array in package.json |
 
 ---

package/bundle/docs/patches/README.md

@@ -8,32 +8,34 @@ it updated whenever a new patch is added or removed.
 
 1. **Clipboard (TERMUX\_\_PREFIX)** – On Termux set `TERMUX__PREFIX` from
    `$PREFIX` so clipboardy detects Termux correctly.
-2. **Optional native modules** – Leave `node-pty`, `keytar`, `tree-sitter-bash`
-   in `optionalDependencies`; build failures are tolerated.
-3. **Core exports** – `packages/core/src/index.ts` re-exports stdio utilities,
+2. **Android PTY prebuild** – Use `@mmmbuto/node-pty-android-arm64` for
+   Termux; remove `@lydell/node-pty-*` and generic `node-pty`.
+3. **Prepare script** – `prepare` is a no-op on Termux to avoid unnecessary
+   bundle/husky work during installs.
+4. **Core exports** – `packages/core/src/index.ts` re-exports stdio utilities,
    hook/telemetry APIs, Termux detectors, and context-memory helpers so CLI
    bundling succeeds on Termux.
-4. **Bundle** – Prebuilt `bundle/gemini.js` shipped in npm package
+5. **Bundle** – Prebuilt `bundle/gemini.js` shipped in npm package
    (ARM64/Android) with policy files under `bundle/policies/`.
-5. **is-in-ci override** – Prevents ink from detecting Termux as CI.
-6. **Punycode warning** – Suppresses deprecation warning on Android.
-7. **Termux detection** – `packages/core/src/utils/termux-detect.ts` utility.
-8. **Postinstall message** – Clear success message on Termux install.
-9. **Context memory + Memory Mode** – JSON memories (base/user/journal) plus
+6. **is-in-ci override** – Prevents ink from detecting Termux as CI.
+7. **Punycode warning** – Suppresses deprecation warning on Android.
+8. **Termux detection** – `packages/core/src/utils/termux-detect.ts` utility.
+9. **Postinstall message** – Clear success message on Termux install.
+10. **Context memory + Memory Mode** – JSON memories (base/user/journal) plus
    presets: `default`, `jit`, `jit+json`. Auto-load toggles, primary selector,
    and MCP import tool (disabled by default; base writes still gated).
-10. **Mobile-first settings** – Compact `/settings` rendering by default on
+11. **Mobile-first settings** – Compact `/settings` rendering by default on
     Termux; TTS toggle exposed (opt-in).
-11. **Shell parser fix** – Base64 polyfill in bundle banner to support
+12. **Shell parser fix** – Base64 polyfill in bundle banner to support
     web-tree-sitter on Node 22/24 (fixes `run_shell_command`).
-12. **MCP SDK typings shim** – Local `.d.ts` shims for
+13. **MCP SDK typings shim** – Local `.d.ts` shims for
     `@modelcontextprotocol/sdk` to satisfy strict builds.
     [Details](./mcp-sdk-typings-shim.md)
 
 ## Expected Warnings
 
-- Missing native modules may log warnings on Termux; functionality remains
-  (non-PTY shell, plain token storage).
+- No node-pty warnings expected on Termux. If PTY fails to load, the CLI
+  falls back to `child_process`.
 
 ## Scope
 

package/bundle/docs/termux-api/EXECUTION_PLAN.md

@@ -117,10 +117,10 @@ if [ ! -f "package.json" ]; then
     exit 1
 fi
 
-# Install dependencies (suppress optional warnings)
+# Install dependencies
 echo ""
 echo "Installing dependencies..."
-npm install --ignore-optional --ignore-scripts 2>&1 | grep -v "npm warn" || true
+npm install
 
 # Build
 echo ""
@@ -148,7 +148,7 @@ Add target:
 # Termux-specific install and build
 termux-install:
 	@echo "=== Installing for Termux ==="
-	npm install --ignore-optional --ignore-scripts
+	npm install
 	npm run build
 	npm run bundle
 	@echo ""
@@ -465,7 +465,7 @@ PHASE 5 (Docs) - High Priority
 
 ```bash
 # 1. Build test
-npm install --ignore-optional --ignore-scripts
+npm install
 npm run build
 npm run bundle
 

package/bundle/docs/termux-api/MERGE_STRATEGY.md

@@ -2,7 +2,7 @@
 
 **Project**: gemini-cli-termux  
 **Author**: DioNanos  
-**Last updated**: 2025-12-28  
+**Last updated**: 2026-01-08  
 **Scope**: Version-agnostic strategy for maintaining all Termux patches
 
 ---
@@ -86,6 +86,8 @@ Likely conflict files:
 - `packages/core/src/services/contextManager.ts` - Keep JIT + JSON wiring
 - `packages/core/src/utils/contextMemory.ts` - Keep JSON memory logic
 - `packages/core/src/tools/shell.ts` - Keep TTS guard
+- `packages/core/package.json` - Keep `@mmmbuto/node-pty-android-arm64` and remove `@lydell/node-pty-*`/`node-pty`
+- `scripts/prepare-termux.cjs` - Keep Termux prepare no-op
 
 ### Step 4: Verify patches intact
 
@@ -100,6 +102,8 @@ ls -la scripts/termux-tools/
 # Check that modifications are present
 grep "TERMUX PATCH" esbuild.config.js
 grep "postinstall" package.json
+grep "@mmmbuto/node-pty-android-arm64" packages/core/package.json
+ls -la scripts/prepare-termux.cjs
 grep "termux-detect" packages/core/src/index.ts
 grep "memory.mode" packages/cli/src/config/settingsSchema.ts
 ```
@@ -107,7 +111,7 @@ grep "memory.mode" packages/cli/src/config/settingsSchema.ts
 ### Step 5: Build test
 
 ```bash
-npm install --ignore-optional --ignore-scripts
+npm install
 npm run build
 npm run bundle
 node bundle/gemini.js --version

package/bundle/docs/termux-api/PATCHES.md

@@ -1,7 +1,7 @@
 # Patch Analysis & Improvement Proposals
 
-**Project**: gemini-cli-termux **Version**: 0.22.0-termux **Author**: DioNanos
-**Date**: 2025-12-17
+**Project**: gemini-cli-termux **Version**: 0.24.6-termux **Author**: DioNanos
+**Date**: 2026-01-08
 
 ---
 
@@ -71,40 +71,38 @@ export default isInCi;
 
 ```json
 {
-  "optionalDependencies": {
-    "@lydell/node-pty": "1.1.0",
-    "@lydell/node-pty-darwin-arm64": "1.1.0",
-    "@lydell/node-pty-darwin-x64": "1.1.0",
-    "@lydell/node-pty-linux-x64": "1.1.0",
-    "@lydell/node-pty-win32-arm64": "1.1.0",
-    "@lydell/node-pty-win32-x64": "1.1.0",
-    "node-pty": "^1.0.0"
+"optionalDependencies": {
+    "@mmmbuto/node-pty-android-arm64": "1.1.0"
   }
 }
 ```
 
 **Purpose**: Allows installation without compiling native modules.
 
-**Status**: ✅ Functional, but with warnings
+**Status**: ✅ Functional, clean install on Termux
 
 **Proposed Improvements**: See
 [Installation Improvements](#installation-improvements)
 
 ---
 
-### 4. esbuild External Modules
+### 4. Prepare Script (Termux)
+
+**File**: `scripts/prepare-termux.cjs`
+
+**Purpose**: Skips `husky` + `bundle` work on Termux installs.
+
+**Status**: ✅ Functional
+
+---
+
+### 5. esbuild External Modules
 
 **File**: `esbuild.config.js`
 
 ```javascript
 const external = [
-  '@lydell/node-pty',
-  'node-pty',
-  '@lydell/node-pty-darwin-arm64',
-  '@lydell/node-pty-darwin-x64',
-  '@lydell/node-pty-linux-x64',
-  '@lydell/node-pty-win32-arm64',
-  '@lydell/node-pty-win32-x64',
+  '@mmmbuto/node-pty-android-arm64',
 ];
 ```
 
@@ -118,14 +116,18 @@ const external = [
 
 ### Issue 1: Warning during npm install
 
-**Symptom**:
+**Symptom (before Termux-only fork)**:
 
 ```
 npm warn optional SKIPPING OPTIONAL DEPENDENCY: @lydell/node-pty@1.1.0
 npm warn notsup SKIPPING OPTIONAL DEPENDENCY: Unsupported platform for @lydell/node-pty-linux-x64
 ```
 
-**Proposed Solution**:
+**Current Status**:
+
+With `@mmmbuto/node-pty-android-arm64`, installs on Termux should be clean and avoid node-gyp.
+
+**Legacy Proposed Solution**:
 
 #### A. Custom postinstall script
 
@@ -173,23 +175,19 @@ if (os.platform() === 'android' || process.env.TERMUX_VERSION) {
 }
 ```
 
-#### B. Documentation .npmrc
+#### B. Documentation .npmrc (legacy)
 
-Create `.npmrc` with:
-
-```ini
-# Suppress optional dependency warnings
-loglevel=error
-optional=false
-```
-
-**Note**: Not recommended globally, but useful for advanced users.
+Previously used to suppress optional dependency warnings. **Do not use
+`optional=false` now**, because it disables the Termux PTY prebuild.
 
 ---
 
-### Issue 2: Build from source requires manual flags
+### Issue 2: Build from source should not require manual flags
+
+**Symptom (before `prepare-termux`)**: `npm install` ran desktop-only prepare
+steps, so users relied on `--ignore-scripts`.
 
-**Symptom**: Users must remember `--ignore-optional --ignore-scripts`.
+**Current Status**: `prepare` is now Termux-aware, so plain `npm install` works.
 
 **Proposed Solution**:
 
@@ -202,12 +200,12 @@ optional=false
 
 # Standard install (desktop)
 install:
-	nnpm install
+	npm install
 
 # Termux-specific install
 termux-install:
 	@echo "Installing for Termux..."
-	npm install --ignore-optional --ignore-scripts
+	npm install
 	npm run build
 	npm run bundle
 	@echo ""
@@ -241,7 +239,7 @@ fi
 
 # Install dependencies
 echo "Installing dependencies..."
-npm install --ignore-optional --ignore-scripts 2>&1 | grep -v "npm warn"
+npm install
 
 # Build
 echo "Building..."

package/bundle/gemini.js

@@ -106968,7 +106968,7 @@ import { fileURLToPath as fileURLToPath4 } from "node:url";
 import path12 from "node:path";
 async function getVersion() {
   const pkgJson = await getPackageJson(__dirname3);
-  return "0.24.5-termux";
+  return "0.24.6-termux";
 }
 var __filename, __dirname3;
 var init_version2 = __esm({
@@ -161895,8 +161895,8 @@ var GIT_COMMIT_INFO, CLI_VERSION;
 var init_git_commit = __esm({
   "packages/core/dist/src/generated/git-commit.js"() {
     "use strict";
-    GIT_COMMIT_INFO = "50a8951a";
-    CLI_VERSION = "0.24.5-termux";
+    GIT_COMMIT_INFO = "6db122206";
+    CLI_VERSION = "0.24.6-termux";
   }
 });
 
@@ -327567,21 +327567,16 @@ var init_getPty = __esm({
   "packages/core/dist/src/utils/getPty.js"() {
     "use strict";
     getPty = async () => {
-      if (process.env["PREFIX"]?.includes("com.termux")) {
+      const isAndroid2 = process.platform === "android" || process.env["PREFIX"]?.includes("com.termux");
+      if (!isAndroid2) {
         return null;
       }
       try {
-        const lydell = "@lydell/node-pty";
-        const module2 = await import(lydell);
-        return { module: module2, name: "lydell-node-pty" };
+        const mmmbuto = "@mmmbuto/node-pty-android-arm64";
+        const module2 = await import(mmmbuto);
+        return { module: module2, name: "mmmbuto-node-pty" };
       } catch (_e) {
-        try {
-          const nodePty = "node-pty";
-          const module2 = await import(nodePty);
-          return { module: module2, name: "node-pty" };
-        } catch (_e2) {
-          return null;
-        }
+        return null;
       }
     };
   }
@@ -342115,7 +342110,7 @@ var init_shellExecutionService = __esm({
                   error: error40,
                   aborted: abortSignal.aborted,
                   pid: ptyProcess.pid,
-                  executionMethod: ptyInfo?.name ?? "node-pty"
+                  executionMethod: ptyInfo?.name ?? "mmmbuto-node-pty"
                 });
               };
               if (abortSignal.aborted) {
@@ -445956,7 +445951,7 @@ var WarningMessage = ({ text }) => {
 };
 
 // packages/cli/src/generated/git-commit.ts
-var GIT_COMMIT_INFO2 = "6db12220";
+var GIT_COMMIT_INFO2 = "6db122206";
 
 // packages/cli/src/ui/components/AboutBox.tsx
 var import_jsx_runtime33 = __toESM(require_jsx_runtime(), 1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mmmbuto/gemini-cli-termux",
-  "version": "0.24.5-termux",
+  "version": "0.24.6-termux",
   "engines": {
     "node": ">=20.0.0"
   },
@@ -14,7 +14,7 @@
     "url": "https://github.com/DioNanos/gemini-cli-termux.git"
   },
   "config": {
-    "sandboxImageUri": "us-docker.pkg.dev/gemini-code-dev/gemini-cli/sandbox:0.24.5-termux"
+    "sandboxImageUri": "us-docker.pkg.dev/gemini-code-dev/gemini-cli/sandbox:0.24.6-termux"
   },
   "scripts": {
     "start": "crossenv NODE_ENV=development node scripts/start.js",
@@ -53,7 +53,7 @@
     "format": "prettier --experimental-cli --write .",
     "typecheck": "npm run typecheck --workspaces --if-present",
     "preflight": "npm run clean && npm ci && npm run format && npm run build && npm run lint:ci && npm run typecheck && npm run test:ci",
-    "prepare": "husky && npm run bundle",
+    "prepare": "node scripts/prepare-termux.cjs",
     "prepare:package": "node scripts/prepare-package.js",
     "release:version": "node scripts/version.js",
     "telemetry": "node scripts/telemetry.js",

package/scripts/postinstall.cjs

@@ -26,10 +26,10 @@ if (isTermux) {
     '║                                                              ║',
   );
   console.log(
-    '║  Note: Native module warnings above are EXPECTED.            ║',
+    '║  PTY: @mmmbuto/node-pty-android-arm64 (no node-gyp).          ║',
   );
   console.log(
-    '║  The CLI works with reduced PTY functionality.               ║',
+    '║  The CLI supports interactive PTY on Termux.                 ║',
   );
   console.log(
     '║                                                              ║',