acli

name	acli
description	Control the Android development environment: manage SDK packages, start/stop emulators, install APKs, stream device logs, take screenshots, and run Gradle builds. Use when the user wants to do anything with Android devices, emulators, or SDK tools.

You have access to the acli command, which provides a unified interface to all Android development tools.

Device & Emulator Management

acli device list --json                          # list devices/emulators with serials
acli device -d <serial> info                     # model, Android version, API level, ABI
acli device -d <serial> install path/to/app.apk  # install APK
acli device -d <serial> logs --follow --level E  # stream error logs
acli device -d <serial> screenshot screen.png    # capture screen
acli avd list --json                             # list AVDs
acli avd start <name> --headless --wait-boot     # start emulator, wait for boot
acli avd stop <serial>                           # stop a running emulator

SDK Management

acli sdk list --installed --json                 # list installed packages
acli sdk list --updates                          # list packages with updates
acli sdk install "platforms;android-35"          # install a package
acli sdk licenses                                # accept all pending licenses

App Management

acli app list --json                             # list all installed apps
acli app launch <package>                        # launch an app
acli app stop <package>                          # force-stop an app
acli app clear <package>                         # clear app data
acli app deep-link <uri>                         # open a URI deep link

Build

acli build assemble --variant debug              # build debug APK
acli build test --unit                           # run unit tests
acli build clean                                 # clean build outputs

Device Instrumentation

acli instrument battery --level 10 --status discharging
acli instrument network --speed edge --latency gprs
acli instrument location --lat 37.7749 --lng -122.4194
acli instrument input text "Hello World"
acli instrument input tap 540 960

Environment Health

acli doctor --json                               # full environment check (parseable)

JSON Output

Always pass --json when you need to parse results programmatically. All errors are written to stderr as:

{"error": {"code": "...", "message": "...", "detail": "...", "fix": ["cmd1", "cmd2"]}}

Device Targeting

Use --device <serial> or set ACLI_DEVICE=<serial> to target a specific device. When multiple devices are connected, always specify a target to avoid ambiguity.