@mmmbuto/gemini-cli-termux 0.24.2-termux → 0.24.4-termux

package/bundle/policies/write.toml

@@ -56,6 +56,11 @@ toolName = "write_file"
 decision = "ask_user"
 priority = 10
 
+[[rule]]
+toolName = "activate_skill"
+decision = "ask_user"
+priority = 10
+
 [[rule]]
 toolName = "write_file"
 decision = "allow"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mmmbuto/gemini-cli-termux",
-  "version": "0.24.2-termux",
+  "version": "0.24.4-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.2-termux"
+    "sandboxImageUri": "us-docker.pkg.dev/gemini-code-dev/gemini-cli/sandbox:0.24.4-termux"
   },
   "scripts": {
     "start": "crossenv NODE_ENV=development node scripts/start.js",
@@ -52,7 +52,7 @@
     "lint:all": "node scripts/lint.js",
     "format": "prettier --experimental-cli --write .",
     "typecheck": "npm run typecheck --workspaces --if-present",
-    "preflight": "npm run clean && npm ci && npm run format && npm run lint:ci && npm run build && npm run typecheck && npm run test:ci",
+    "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:package": "node scripts/prepare-package.js",
     "release:version": "node scripts/version.js",
@@ -80,6 +80,7 @@
   ],
   "devDependencies": {
     "@octokit/rest": "^22.0.0",
+    "@types/js-yaml": "^4.0.9",
     "@types/marked": "^5.0.2",
     "@types/mime-types": "^3.0.1",
     "@types/minimatch": "^5.1.2",
@@ -96,8 +97,8 @@
     "esbuild-plugin-wasm": "^1.1.0",
     "eslint": "^9.24.0",
     "eslint-config-prettier": "^10.1.2",
+    "eslint-plugin-headers": "^1.3.3",
     "eslint-plugin-import": "^2.31.0",
-    "eslint-plugin-license-header": "^0.8.0",
     "eslint-plugin-react": "^7.37.5",
     "eslint-plugin-react-hooks": "^5.2.0",
     "glob": "^12.0.0",

package/bundle/README.md

@@ -1,239 +0,0 @@
-# 🤖 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.