# Android CLI

> Google’s CLI lets coding agents build, deploy, and inspect Android apps on emulators and remote physical phones through Android Device Streaming.

Android CLI is a command-line interface from Google's Android team that standardizes core Android development tasks for agent-first workflows. Agents or scripts can set up the SDK, scaffold projects, manage emulators, install APKs, inspect device screens, and reach Android skills and the Android Knowledge Base. It is distinct from the Android Studio IDE, although it can connect to a running Studio instance.

## What It Is

Android CLI is a terminal entry point to official Android tooling, usable with any agent or editor of your choice. The documentation also describes it as a way to streamline CI, maintenance, and scripted automation. Commands are grouped by area, including auth, create, describe, device, docs, emulator, init, install, layout, run, screen, sdk, skills, studio, and update.

## Agent Workflow

Running `android init` installs the `android-cli` skill so agents understand how to use the tool. Agents can then scaffold new projects from templates, automate environment and SDK setup, manage virtual devices, install APKs, and capture live device screens and UI hierarchies. Through the `android studio` commands they can connect to running Android Studio instances for semantic code analysis, Compose preview rendering, and dependency version lookups. The CLI also supports testing apps with Journeys.

## Android Skills

The `android skills` commands add, find, list, update, and remove Android skills. These are markdown SKILL.md instructions published in the android/skills repository under the Apache License 2.0, intended to ground LLMs in Android best practices. The repository states its skills focus on workflows where evaluations show LLMs underperform.

## Remote Physical Devices

The `android device remote` commands (connect, create, disconnect, extend, list, models, projects, remove) let you reserve and connect to remote physical Android devices. Per the Android Device Streaming documentation, these devices are hosted in Google's secure data centers and Android Partner Device Labs, reached over an ADB over SSL connection. They are real hardware, not emulators. The CLI requires Google sign-in and a Google Cloud project ready for streaming, including required APIs, permissions, and billing. Streaming usage follows Firebase quotas and billing. Devices are wiped and factory reset when a session ends.

## Setup and Limits

Download the CLI and run `android update` to stay current. A `.androidrc` file can apply default flags such as `--sdk`. It runs on macOS, Linux, and Windows, with documented Windows limits: the `android emulator` command is currently disabled, and downloading from Windows PowerShell isn't supported. The CLI collects basic usage data, which can be disabled with the `--no-metrics` flag.

## The Closed Development Loop

An agent can write code, build an APK, reserve a physical phone, deploy the APK through ADB, inspect its screen and UI hierarchy, and use the observed result to make the next fix. The September remote-device commands made physical hardware accessible from the terminal; the October release connects a new reservation to ADB automatically. Device inspection provides feedback, but teams still need assertions and appropriate tests to establish correctness.

## Features
- Automated Android SDK and environment setup
- Project scaffolding from templates
- Emulator management (create, start, stop, list, remove)
- APK installation and app running from the terminal
- Live device screen capture and UI hierarchy inspection
- Remote physical device reservation via android device remote
- Android Studio integration for code analysis, Compose preview rendering, and version lookups
- Android skills install and update for coding agents
- Android documentation search and fetch
- Journeys-based app testing
- Configurable defaults via .androidrc
- Opt-out usage metrics with --no-metrics

## Integrations
Android Studio, Android Device Streaming, Firebase Test Lab, Android SDK, ADB, Android skills

## Platforms
MACOS, LINUX, WINDOWS, CLI

## Pricing
Freemium — Free tier available with paid upgrades

## Version
1.0.16500706

## Links
- Website: https://developer.android.com/tools/agents/android-cli
- Documentation: https://developer.android.com/tools/agents/android-cli/commands
- EveryDev.ai: https://www.everydev.ai/tools/android-cli