⚠️ End-of-life notice — effective 18 June 2026On 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-cliremains 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-termuxto 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).
pkg install nodejs-lts
pkg install termux-api # optional, only for TTS notifications
npm install -g @mmmbuto/gemini-cli-termux@latest
gemini --versionRequirements:
- Termux from F-Droid
- Node.js 20+
termux-apionly if you wanttermux-tts-speakintegration
For non-Termux platforms, use upstream:
npm install -g @google/gemini-clicd your-project
geminiHeadless:
gemini -p "Explain this project" -o jsonUseful slash commands:
/help/auth/model
This fork adds or preserves:
- Android ARM64 PTY support through
@mmmbuto/pty-termux-utils termux-open-urlintegration for auth/browser flows- optional
tts_notificationsupport backed bytermux-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.shTermux 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.
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 --versionOptional Termux helper:
bash scripts/termux-setup.shThe public release checklist lives in:
Minimum smoke:
gemini --version
gemini --help
gemini -p "Reply with OK"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.
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.
Maintained by DioNanos as the Termux/Android porting and distribution fork.
See MAINTAINER.md and NOTICE.
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.