# dev-phone — the mobile verification loop your agents will love

dev-phone gives a coding agent hands and eyes on a real, on-demand Android phone:
get your app running on a leased device, then observe it, act on it, and capture
evidence that the change works.

## Install
curl -fsSL https://dev-phone.com/install.sh | sh

## Zero to verified (cold start)
dev-phone login                                                       # authenticate this CLI
dev-phone run --build-file ./app.apk --bundler http://127.0.0.1:8081  # lease + install + wire Metro + launch; prints the leased <session> handle
dev-phone observe <session>                                           # screen elements (stable refs), errors, log delta
dev-phone tap <session> testid=add-task                               # act on a ref or selector
dev-phone evidence capture <session> --kind screenshot                # proof: a saved screenshot artifact

## Interaction verbs — each returns the full observation package
observe <session>                    current screen: elements, errors, logs  (--full)
tap <session> <target>               tap a ref, selector, or at=X,Y          (--long, --double)
type <session> <target> <text>       focus an element and type               (--enter)
swipe <session> up|down|left|right   swipe the screen, or --on <target>
key <session> back|home|enter        press a device key
open <session> <url>                 open a deeplink on the device
wait <session> [selector]            wait for an element                     (--gone, --rendered)

## More
Everything is self-teaching and side-effect free: run `dev-phone --help`.
Capture other evidence with `dev-phone evidence capture <session> --kind logs|tree`.
Home: https://dev-phone.com