ZeptapDocs
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

OptionDescription
<query>Print only lines containing this text, case-insensitive. --text <query> also works
--exactMatch the whole line instead of a substring

Also takes the global options.

Details

  • Each line is @tN x,y text. x,y is the line's center in screenshot pixels, origin top-left.
  • The refs are remembered for that phone until the next look. Pass one to tap, double-tap or long-press. A ref whose text has gone away is refused with exit code 3. See Refs.
  • look reads the phone's own language: Chinese, Japanese, and so on.
  • Text is far cheaper for an agent than an image. Use screenshot for icons, images and layout.
  • With --json, each entry in lines also 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" --exact

MCP tool

find_text. Flags are arguments.

On this page