Skip to content

DioNanos/gemini-cli-termux

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6,314 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Gemini CLI Termux

npm version License

⚠️ End-of-life notice — effective 18 June 2026

On 18 June 2026, Google will stop serving Gemini CLI requests for the Google AI free tier, Google AI Pro and Google AI Ultra, including the OAuth path used by most Termux users. Free-tier users are being migrated upstream to Antigravity CLI.

Upstream google-gemini/gemini-cli remains Apache-2.0 open source, but only paid enterprise paths (Vertex AI, Gemini Enterprise, Gemini Code Assist Standard/Enterprise) are expected to keep working after that date.

Despite the scheduled EOL, this fork has been refreshed one last time to 0.46.0-termux to align with the final upstream stable line. This is a one-time courtesy update past the freeze; no further upstream tracking is planned. The repository stays as an Apache-2.0 working archive for study and reference.

Per aspera ad astra.

Termux-first build of Gemini CLI for Android ARM64.

This fork tracked upstream release-by-release with the fork delta limited to Android/Termux compatibility, packaging, and validation assets.

Latest fork release: 0.46.0-termux (one-time refresh past the freeze; consumer EOL effective 18 June 2026).

Install

pkg install nodejs-lts
pkg install termux-api   # optional, only for TTS notifications

npm install -g @mmmbuto/gemini-cli-termux@latest
gemini --version

Requirements:

  • Termux from F-Droid
  • Node.js 20+
  • termux-api only if you want termux-tts-speak integration

For non-Termux platforms, use upstream:

npm install -g @google/gemini-cli

Usage

cd your-project
gemini

Headless:

gemini -p "Explain this project" -o json

Useful slash commands:

  • /help
  • /auth
  • /model

Termux Delta

This fork adds or preserves:

  • Android ARM64 PTY support through @mmmbuto/pty-termux-utils
  • termux-open-url integration for auth/browser flows
  • optional tts_notification support backed by termux-tts-speak
  • Termux environment detection for runtime-specific behavior
  • release validation docs under test-reports/

After upstream merges or release prep, verify the fork delta with:

bash scripts/check-termux-patches.sh

Authentication

Termux supports the same user-facing auth paths as upstream Gemini CLI.

Interactive auth:

/auth

API-key auth:

export GEMINI_API_KEY="YOUR_GEMINI_API_KEY"

When a browser URL must be opened on Android, the fork uses termux-open-url.

Build

git clone https://github.com/DioNanos/gemini-cli-termux.git
cd gemini-cli-termux
npm install
npm run build
npm run bundle
node bundle/gemini.js --version

Optional Termux helper:

bash scripts/termux-setup.sh

Release Validation

The public release checklist lives in:

Minimum smoke:

gemini --version
gemini --help
gemini -p "Reply with OK"

Maintenance Scope

In scope for this fork:

  • Android/Termux runtime compatibility
  • npm package @mmmbuto/gemini-cli-termux
  • Termux validation reports and release assets
  • minimal fork-owned GitHub CI/release automation

Out of scope:

  • generic Gemini CLI feature requests
  • upstream product behavior unrelated to Termux
  • upstream Google infrastructure, bots, or release workflows

Generic issues should be filed upstream at google-gemini/gemini-cli. Termux-specific issues should be filed here.

Security

See SECURITY.md.

Termux-fork-specific security reports: security@mmmbuto.com.

Upstream-relevant security reports should follow the upstream Google security process described in SECURITY.md.

Maintainer

Maintained by DioNanos as the Termux/Android porting and distribution fork.

See MAINTAINER.md and NOTICE.

License

Apache-2.0. This fork is distributed under the same license as upstream Gemini CLI. The Android/Termux compatibility patches are distributed under Apache-2.0 as well.

About

[EOL scheduled 18 June 2026] Android/Termux fork of Google Gemini CLI, frozen at 0.42.0-termux. Google will stop serving free/OAuth Gemini CLI requests on 18 June 2026; upstream points users to Antigravity CLI. Apache-2.0 archive for study and reference.

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • TypeScript 97.9%
  • JavaScript 1.8%
  • Shell 0.2%
  • C# 0.1%
  • HTML 0.0%
  • Dockerfile 0.0%