ADB Claw — Android Device Control

ADB Claw — Android Device Control

Your eyes, hands, and ears on Android. See what's on screen, tap any element, scroll through content, open deep links, wait for UI changes, capture system audio, manage apps, and more — all through a single CLI with structured JSON output.

Why ADB Claw

Superpowers — What You Can't Get Elsewhere:

• Live stream intelligence — monitor connects to Android's accessibility framework, reading all UI text in real-time — even during video playback and live streams where uiautomator dump hangs. Chat messages, captions, dynamic overlays — data no other tool exposes to agents.
• System audio capture — audio capture records device audio via REMOTE_SUBMIX (Android 11+); streams WAV to stdout for piping to ASR tools. Combined with monitor, you get full sensory coverage: visual text + audio.

Core Strengths:

• Observe → Act → Verify loop — observe returns screenshot + indexed UI tree in one call; use element indices to target precisely across any screen size
• Deep links bypass CJK limits — adb input text can't type Chinese/Japanese/Korean; adb-claw open 'app://search?keyword=中文' can
• Wait, don't poll — wait --text "Done" blocks until the UI element appears, replacing fragile sleep/observe loops
• Smart scroll — auto-calculates swipe coordinates from screen size; supports direction, page count, and scrolling within specific elements
• App Profiles — pre-built knowledge (deep links, layouts, known issues) for popular apps like Douyin; load once, skip trial-and-error
• Full app lifecycle — install, launch, stop, uninstall, clear data — no raw adb needed
• Agent-optimized JSON — every command returns {ok, command, data, error, duration_ms} with actionable suggestion on errors
• Minimal device footprint — nearly all operations are pure ADB commands; only monitor and audio capture push temporary ~7KB helpers that auto-exit

Actively Evolving — new capabilities ship regularly. Each release expands what you can perceive and control on Android devices.

Getting Started

Claude Code

Install the plugin, then just talk to Claude — no slash commands needed:

claude plugin add llm-net/adb-claw

The plugin auto-downloads the adb-claw binary on first session. Make sure adb is installed and a device is connected via USB with debugging enabled.

Then simply ask Claude to interact with your Android device:

"Take a screenshot of my phone"
"Open Douyin and search for 猫咪"
"Tap the Login button"