Tools & Products

Antigravity CLI 1.2.15 Lands on Android via Termux: Full Agent Runtime on Mobile

Google Antigravity released CLI version 1.2.15, bringing the complete agy autonomous coding agent to Android devices running Termux with ARM64 binary parity, background daemons, and direct GitHub sync.

By FreakVinci · 2026-10-03 · 12 min read

Antigravity CLI version 1.2.15 introduces native support for Android environments running through Termux. This release ports the complete agy agent runtime to ARM64 Android userlands, eliminating the gap between desktop workstations and pocket hardware.

Developers can now trigger agent tasks, inspect repository diffs, run test suites, and commit changes straight from a smartphone terminal.

# Install the official Antigravity CLI build on Termux
curl -fsSL https://antigravity.google/cli/install.sh | bash

# Verify binary architecture and launch the agent
agy --version
agy

Why Running agy on Android Matters

Terminal agents typically demand x86_64 host machines or cloud containers accessed through thin SSH clients. When network connectivity drops, cloud sessions disconnect, and headless instances rack up hourly compute bills.

Antigravity 1.2.15 runs the agent logic, token orchestrator, and tool runner directly inside Termux's Linux compatibility environment. The phone handles tool execution, shell scripts, and workspace edits locally, dispatching inference calls to remote model APIs or local Ollama servers over Wi-Fi and 5G.

Metric Desktop CLI (x86_64) Termux Mobile CLI (aarch64)
Binary Footprint 48.2 MB static ELF 39.7 MB static PIE ELF
Idle Memory (RSS) 78 MB 62 MB
Active AST Indexing (10k LOC) 185 MB RAM / 1.4s 234 MB RAM / 2.8s (Snapdragon 8 Gen 3)
Android Root Required No No (Runs in unprivileged Termux proot/chroot)
Tool Calling Support Complete (bash, read, edit, git) Complete (Termux-pkg bash, ripgrep, git, node)
Background Continuity Systemd / tmux daemon Termux wake-lock + Tmux session

Step-by-Step Installation on Termux

Setting up agy on an Android device takes less than three minutes. Follow these verified commands:

1. Update Termux Packages and Install Core Dependencies

pkg update && pkg upgrade -y
pkg install curl git openssh nodejs-lts ripgrep -y

2. Run the Official Installer

curl -fsSL https://antigravity.google/cli/install.sh | bash

The shell script detects the aarch64-linux-android architecture, downloads the matching precompiled binary, verifies the SHA-256 checksum, and links agy into $PREFIX/bin/agy.

3. Request Wake-Lock to Prevent Android OS Doze

Android aggressively halts background terminal apps when the screen shuts off. Grant Termux battery exemption and acquire a wake-lock before kicking off long-running tasks:

termux-wake-lock

4. Authenticate and Start Your First Task

# Configure your Anthropic, Google, or custom API gateway
export GEMINI_API_KEY="your-api-key"
export ANTHROPIC_API_KEY="your-api-key"

# Clone your project and trigger agy
cd ~/projects/my-mobile-app
agy "Audit dependencies in package.json and replace deprecated modules"

Architectural Implementation: What Changed in 1.2.15

Porting a desktop agent to Android required resolving three platform constraints:

1. Dynamic Linking Against Bionic libc

Desktop Linux binaries link against GNU glibc. Termux uses Android's Bionic libc, which lacks several glibc-specific system calls and stores filesystem paths under /data/data/com.termux/files/usr rather than standard /usr.

Version 1.2.15 builds the Go-and-Rust runtime with statically embedded musl or targeted Bionic headers. Path resolution dynamically queries the $PREFIX environment variable, ensuring tool hooks locate /bin/sh, python, and git correctly.

2. Process Tree Management Under Low-Memory Killer (LMK)

Android's kernel aggressively reaps child processes when memory pressure climbs. The agy executor now pools child subprocesses through sequential queueing rather than launching wide parallel subshells for tests and linters. This keeps total resident memory well within Android limits.

3. Hardware Keyboard and Touch Terminal Ergonomics

The interactive terminal UI (TUI) incorporates condensed split panes formatted for 360px to 420px mobile viewport widths. Key bindings map neatly to volume-button modifiers or virtual keyboard accessory rows.


Real-World Mobile Workflows

  1. On-Call Incident Resolution: Pull logs from production, ask agy to locate the stack trace in your cloned repository, create a patch branch, and open a pull request without opening a laptop.
  2. Reviewing Code Diffs During Transit: Inspect teammate PRs, run automated test suites natively on the phone's ARM chip, and push suggestions directly.
  3. Triggering Autonomous Background Refactors: Fire up a tmux session, launch agy "Add unit tests for all functions in src/utils", lock your phone, and return to find tests written and verified.

Troubleshooting Common Termux Errors

  • Error: permission denied /data/data/com.termux...: Ensure you did not run the installer with sudo. Termux runs as a single user ID; root privileges are unnecessary.
  • Agent stalls when screen locks: Run termux-wake-lock and turn off "Battery Optimization" for Termux in Android Settings.
  • Node tools missing: Run pkg install nodejs inside Termux. agy uses the host system's installed compilers and package managers to run code.