looktap

List what is on screen: @ref, type, x,y, width×height, label, = value.

Tap an element by label or @ref. Returns the settled screen.

Tap a point (iOS points / Android dp, the units ls prints).

Hold a touch on an element (or a point) for ms (default 800).

Focus a text field (by label or @ref), clear it, type text, and check the field holds it (a password field: its length). Retypes slowly if not, and fails if it still does not.

Put text on the device's clipboard, check it is there, and paste it into the focused field.

Enter a one-time code into its row of digit boxes: tap the first, type each digit, check every box (pastes the code if typing did not fill them).

Type into the focused field.

Press keys: return, escape, delete, tab, space, selectall, paste, home (Android also back).

Dismiss the on-screen keyboard and take focus from the field (blur validation runs). Fails if it is still up.

Drag from one point to another (scroll: finger moves up to go down).

Swipe until the element is fully on screen (swipes above the keyboard when it is up).

Android system Back; iOS navigation-bar back button.

The Home button: go to the home screen, leaving the app running.

Wait until a label (or @ref) is on screen — or, with gone, until it is not. With settle and no target: until the screen, its picture included, holds still for a second, for web pages with no labels to wait for (a sign-in page loading).

A PNG of the screen, returned as an image (scale 0.5 by default: fewer tokens).

The app's log since the last logs call (first call: the last minute).

Crash reports, ANRs and low-memory kills since the last crashes call.

The app's CPU (100% = one core), memory and threads; or, with frames, frames drawn since the last frames call: janky share, p50–p99 frame time, fps (iOS counts what the screen shows; its first frames call only starts counting, so call it before the action too). Simulator numbers are the Mac's: compare runs, not phones. A real iPhone reads through Instruments, 10–25 s a reading.

Any other looktap command line, or several separated by ";" — e.g. "launch com.example.app --ls", "stop com.example.app", "open myapp://home", "expect Welcome", "zoom in", "appearance dark", "rotate landscape", "fold open", "record start demo" … "record stop", "permission grant location com.example.app", "perf com.example.app --for 10s", "launch com.example.app --time", "apps com.example" (is it installed?), "app com.example.app --paths" (its data folder), "devices --all", "boot Pixel_9a" (also waits for one still starting), "shutdown Pixel_9a", "dismiss logbox" (React Native's toast), "shot sign-in --points" (pixels = tapxy units), "doctor -d <device>", "--wait-unlock 60 launch com.example.app", "handoff \"Approve the sign-in on the phone\" --until Home" (the user's turn: waits for that label). See: help.