List available Android Virtual Devices (AVDs) and currently connected devices/emulators

Boot an Android emulator by AVD name and wait until it has finished booting. Returns the device serial.

Shut down a running emulator

Get the serial(s) of currently connected devices/emulators

Get the screen size (pixels) and density. Screenshots, tap coordinates and describe_ui bounds all share this same pixel coordinate space — no scaling needed.

Install an .apk on the device

Uninstall an app by package name

List installed packages (third-party only by default)

Launch an app by package name (uses its main launcher activity), or a specific activity

Force-stop a running app

Clear all data and permissions for an app (like a fresh install)

Grant a runtime permission to an app (e.g. android.permission.CAMERA)

Take a screenshot of the device screen. Saves a full-resolution PNG and returns a downscaled copy inline (the text notes the scale factor to map back to device pixels).

Get the UI hierarchy of the current screen as a compact JSON list with text, content descriptions, resource IDs, bounds and tap centers (pixels). By default only elements with text/desc or that are interactive are returned.

Find UI elements whose text, content description or resource ID contains the given string (case-insensitive). Returns bounds and tap centers.

Poll until an element matching the query appears (or disappears). Useful after navigation or network calls.

Tap at x,y pixel coordinates on the screen

Long-press at x,y pixel coordinates

Swipe from one point to another (pixels)

Type text into the currently focused input field (ASCII only — adb input text cannot type emoji or non-Latin characters)

Press a hardware/navigation button (HOME, BACK, MENU, APP_SWITCH, POWER, VOLUME_UP, VOLUME_DOWN, ENTER, DEL, TAB, CAMERA, SEARCH)

Send any Android keycode (e.g. KEYCODE_ESCAPE, 66) — for keys not covered by press_button

Open a URL or deep link in the device

Shake the device (emulator only — simulates accelerometer motion, e.g. to open the React Native dev menu)

Rotate the screen

Switch the device between light and dark mode

Set the simulated GPS location (emulator only)

Add a photo or video to the device's media library (Photos/Gallery)

Start recording the device screen (max 3 minutes per recording). Call stop_recording to finish and pull the .mp4.

Stop an active screen recording and save the video locally

Override the status bar via SystemUI demo mode (time, battery, wifi, notifications)

Exit demo mode and restore the real status bar

Read recent logcat output, optionally filtered by a regex or restricted to one app's process

Clear the logcat buffer

Copy a local file to the device

Copy a file from the device to the local machine

Run an arbitrary adb shell command for anything not covered by the other tools, e.g. 'dumpsys activity activities | head -50'