List all connected Android devices with their state, model, and product info

Get detailed properties for a connected device (model, OS version, build, etc.)

Get a specific Android system property, or all properties if no key given

Execute a shell command on the Android device. Returns stdout and stderr.

Execute a command as root via su. Requires rooted device.

Install an APK on the device. Provide the full local path to the APK file.

Uninstall a package from the device

List installed packages. Supports filtering by name.

Get detailed info about an installed package (version, permissions, paths)

Clear all data for a package (equivalent to clearing storage in settings)

Grant a runtime permission to a package

Revoke a runtime permission from a package. Useful for resetting permission state to test first-run flows or denial handling.

List permissions declared and granted for a package. Parses the package dump to show install-time and runtime permissions with their current grant state. Useful for auditing permission state before and after grant/revoke operations.

Force-stop an app immediately. The most common debugging action.

Launch an app by package name (resolves and starts the default launcher activity)

Force-stop then re-launch an app. The most frequent debugging workflow in a single call.

Discover all activities, services, and receivers registered by a package with their intent filters

Push a local file to the device filesystem. Pre-flight checks: hard-blocked kernel paths, filesystem type warnings, symlink resolution, and destination storage availability.

Pull a file from the device to local filesystem

List files and directories on the device

Read a text file from the device

Create or overwrite a text file on the device. Content is delivered via shell heredoc — suitable for config files, scripts, test fixtures, and small data files. For large or binary files, use adb_push instead. Shell buffer limits content to approximately 128KB.

Search for files on the device by name or pattern. Uses the find command with glob matching. Results are capped at maxResults to prevent unbounded output. Reports whether results were truncated.

Get detailed file metadata: size, permissions, ownership, timestamps (access/modify/change), SELinux security context, and file type. Read-only operation.

Compute SHA-256 hash of a file on the device. Critical for firmware integrity verification, tamper detection, and comparing files across devices. Read-only operation. Reports file size alongside the hash.

Create a directory on the device. Supports -p flag for creating parent directories.

Delete a file or directory on the device. Recursive deletion uses depth-based protection: refuses at depth ≤ 2 from root (blocks rm -rf /system or /sdcard but allows /sdcard/project/build/). Symlinks are resolved before depth checks to prevent traversal bypasses. Hard-blocks /dev, /proc, /sys. For recursive deletes, reports a pre-flight file count.

Move or rename a file/directory on the device. Moving FROM a system path is destructive — source depth protection refuses if source is at depth ≤ 1 from root. Symlinks resolved before checks. Cross-filesystem moves (e.g., /data → /sdcard) do a copy+delete internally and can be slow for large files.

Copy a file or directory on the device. Pre-flight checks source size against destination available space. Post-verifies the copy by comparing file sizes. For recursive directory copies, use -r flag.

Change file permissions on the device. Mode must be a valid octal string (e.g., '755', '644', '600'). Recursive mode uses depth-based protection: refuses at depth ≤ 2 from root. Note: sdcardfs/FUSE ignores Unix permissions — file access on /sdcard is controlled by Android's package ownership model.

Create an empty file or update timestamps. Three modes: create (touch non-existent path), update (set atime/mtime to now), or set explicit timestamp. On FAT32, timestamps have 2-second resolution. On tmpfs, timestamps are volatile.

Report filesystem details for any path: filesystem type, mount point, mount options, capacity, usage, read-only status, permission support, symlink support, max file size, timestamp resolution, encryption status, and SELinux context. Essential for understanding what operations are possible before attempting them.

Change file ownership on the device. Requires root. Supports both numeric UID:GID (e.g., '10150:10150') and symbolic user:group (e.g., 'system:system'). Recursive mode uses depth-based protection: refuses at depth ≤ 2 from root. Note: sdcardfs/FAT32 ignore ownership changes.

Search file contents on the device by text pattern. Uses fixed-string matching by default (no regex injection risk). Supports recursive directory search with depth control and result capping. For filename searches, use adb_find instead.

Find and replace text in a file on the device. Uses sed internally with proper escaping — exposes a safe interface without requiring sed syntax knowledge. Supports global replacement, line-targeted edits, and optional backup creation. Reports match count.

Capture a logcat snapshot. Supports tag filtering, priority levels, and grep patterns.

Clear all logcat buffers on the device

Get recent crash logs from the crash buffer

Run dumpsys for a specific service. Use 'list' as the service to see all available services.

Get telephony state including cell info, signal strength, and network registration.

Get battery status, level, temperature, and charging info

Get network connectivity info including WiFi, cellular, and active connections

Get current CPU and memory usage snapshot

Capture a performance snapshot for a package: memory usage, frame stats, and CPU info in one call.

Capture a full bug report zip (device state, logs, dumpsys, system info). Returns the local file path.

Read ANR (Application Not Responding) traces and tombstone crash dumps from the device. Requires root access for /data/anr/ and /data/tombstones/. Returns the most recent entries.

Capture a heap dump from a running process for memory analysis. Triggers am dumpheap and pulls the resulting .hprof file. Requires the target process PID or package name.

Take a screenshot and save to local filesystem. Returns the file path.

Get the currently focused activity and window stack

Send input events to the device (tap, swipe, text, keyevent)

Start an activity or app by intent or component name

Dump the current UI hierarchy. Parses the view tree into structured element data with coordinates, text, resource IDs, and interaction flags. Use format='tsv' for token-efficient compact output, format='xml' for raw uiautomator XML.

Search the UI hierarchy for elements matching text, resource-id, or content-description. Returns matching elements with coordinates for precise adb_input targeting.

Take a screenshot with UI element bounding boxes and numbered labels composited directly onto the image. Returns the annotated PNG path plus a text legend mapping each element number to its identity. Ideal for LLM workflows that need to reference specific UI elements by number rather than by coordinates.

Get a combined screen state snapshot in one call: foreground activity, screen dimensions and density, orientation, battery level, and a TSV list of interactive UI elements. Replaces 3-4 separate tool calls with a single round-trip. Ideal as a first step in any automation workflow.

Run a Gradle task in an Android project directory

Build a debug APK and install it on the connected device (convenience wrapper)

Run a comprehensive health check of the ADB toolchain. Validates: ADB binary, server, device connection, authorization, and root access.

Pair with a device over WiFi using the pairing code from Developer Options → Wireless debugging → Pair device

Connect to a device over WiFi/TCP. Device must be paired first or have TCP/IP enabled.

Disconnect from a wireless device, or all wireless devices if no host specified

Switch a USB-connected device to TCP/IP mode on the specified port (default 5555). After this, you can disconnect USB and use adb_connect.

Toggle airplane mode on/off. Useful for resetting cellular registration during radio testing.

Enable or disable WiFi

Enable or disable mobile data

Enable or disable location services

Control screen state: wake, sleep, toggle, lock, or unlock. Lock and unlock verify actual keyguard state via dumpsys window. Unlock uses wm dismiss-keyguard (works for swipe keyguards); supply 'pin' to perform the full PIN entry sequence for PIN-protected devices: wakes screen, dismisses keyguard, swipes up to reveal keypad, types PIN, confirms with ENTER, and verifies the keyguard sleep token was released.

Cycle airplane mode on then off after a delay. Forces cellular re-registration — useful for radio diagnostics and network testing.

Read an Android settings value from any namespace (system, secure, global)

Write an Android settings value to any namespace (system, secure, global)

Reboot the device. Supports normal, recovery, and bootloader modes.

Start a background logcat watcher. Lines accumulate in a ring buffer. Use adb_logcat_poll to retrieve new entries.

Retrieve new logcat lines since the last poll from a running watcher session.

Stop a running logcat watcher session

List all active logcat watcher sessions

Forward a local port to a port on the device (host → device). Use for connecting to services running on the device.

Reverse-forward a device port to a port on the host (device → host). Use for letting device apps reach services on your machine.

List all active port forwards and reverse forwards

Remove a port forward (host → device), or all forwards. Use after testing to clean up.

Remove a reverse forward (device → host), or all reverse forwards. Use after testing to clean up.

Start recording the device screen. Recording runs on-device. Use adb_screenrecord_stop to finish and pull the video file.

Stop an active screen recording and pull the video file locally. If the recording has already finished (hit time limit), this just pulls the file.

List all available Android Virtual Devices (AVDs) that can be started.

Launch an Android Virtual Device (AVD) emulator. Returns once the emulator process has started.

Stop a running emulator. Uses 'adb emu kill' for graceful shutdown.

Check and install QEMU for on-device virtualization. Verifies KVM availability, checks if QEMU is installed, reports version info, and can install QEMU via Termux package manager. Only available in on-device mode.

Manage QEMU disk images for virtual machines. List available images, create new qcow2/raw disk images, or delete existing ones. Images are stored in the DeepADB image directory.

Boot a QEMU virtual machine with KVM hardware acceleration. Auto-detects optimal resource allocation: uses total cores minus 1 for the VM (reserving one for the host OS), and up to 65% of physical RAM. Custom values are accepted but capped at safe limits to prevent host starvation.

Stop a running QEMU virtual machine. Sends SIGTERM for graceful shutdown, with force kill option.

Show status of QEMU virtual machines — running VMs with resource usage and port mappings, plus KVM and QEMU availability.

Connect to a running QEMU VM's ADB service, making the guest appear as a device for DeepADB tools. Requires the guest OS to have an ADB daemon running (e.g., Android guest with USB debugging enabled). Requires the 'adb' binary (install with: pkg install android-tools). Connections are restricted to localhost only — no remote host connections allowed.

Disconnect from a QEMU VM's ADB service. Removes the guest from the device list.

Execute a shell command on a QEMU guest VM via ADB. The VM must be connected first (use adb_qemu_connect). The guest serial is derived internally — no user-supplied host/IP reaches the ADB binary. Subject to the same security middleware checks as adb_shell.

Start a structured test session. Creates a named directory for organizing numbered screenshots and logcat captures.

Capture a numbered test step: takes a screenshot and captures logcat since the last step. Saves both to the session directory.

End the active test session. Writes a summary manifest and returns the session directory path.

Execute a shell command on multiple (or all) connected devices in parallel. Returns results grouped by device.

Install an APK on multiple (or all) connected devices in parallel.

Run a command on all devices and compare outputs side by side. Highlights differences across devices.

Run a comparative test workflow across all connected devices (host + QEMU guests). Executes a predefined diagnostic profile or custom command list on every device in parallel, compares results per-check, and reports matches and differences. Profiles: 'firmware' (baseband, bootloader, kernel, security patch), 'security' (SELinux, verified boot, encryption), 'network' (radio, WiFi, SIM), 'identity' (model, chipset, architecture), 'full' (all profiles). Custom commands also supported.