Commands
look
Read the screen with on-device OCR. Prints one line per label, top to bottom, each with a @t ref and its center.
Usage
zeptap look
zeptap look <query> [--exact]screentext and find are aliases.
Options
| Option | Description |
|---|---|
<query> | Print only lines containing this text, case-insensitive. --text <query> also works |
--exact | Match the whole line instead of a substring |
Also takes the global options.
Details
- Each line is
@tN x,y text.x,yis the line's center in screenshot pixels, origin top-left. - The refs are remembered for that phone until the next
look. Pass one totap,double-taporlong-press. A ref whose text has gone away is refused with exit code 3. See Refs. lookreads the phone's own language: Chinese, Japanese, and so on.- Text is far cheaper for an agent than an image. Use
screenshotfor icons, images and layout. - With
--json, each entry inlinesalso has the line's box.
Examples
$ zeptap look -l 7
screen: 591x1280 px
text (4 lines, @tN x,y text):
@t1 295,88 Settings
@t2 160,512 General
@t3 186,590 Accessibility
@t4 150,668 Privacy & Security
$ zeptap look -l 7 general # only matching lines
$ zeptap look -l 7 "Privacy & Security" --exactMCP tool
find_text. Flags are arguments.