Android Device Control

Operate a connected Android device through the android-bridge CLI. Every interaction follows a perceive → locate → act → verify → escalate loop. The CLI is the single source of truth; this file is the agent-facing manual.

Every command prints [profile: <name>] on the first line of stderr (success or failure — defaults to [profile: default] when no profile is active). That is by design: use it to confirm which device is active. Stdout carries results; stderr carries diagnostics.

Quick Start

pipx install git+https://github.com/briqt/android-bridge.git   # install CLI
android-bridge connect 192.168.1.100:5555                       # connect (WiFi ADB; remembered)
android-bridge snapshot                                          # read screen (native apps)
android-bridge dump                                              # read screen (Flutter/Compose apps)
android-bridge tap 540 1200                                      # act

Command Quick Reference