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