# look

> Read the screen with on-device OCR. Prints one line per label, top to bottom, each with a @t ref and its center.

Source: https://zeptap.com/docs/cli/commands/look



## Usage [#usage]

```sh
zeptap look
zeptap look <query> [--exact]
```

`screentext` and `find` are aliases.

## Options [#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](https://zeptap.com/docs/cli#global-options).

## Details [#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`](https://zeptap.com/docs/cli/commands/tap), `double-tap` or `long-press`. A ref whose text has gone away is refused with exit code 3. See [Refs](https://zeptap.com/docs/cli/output#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`](https://zeptap.com/docs/cli/commands/screenshot) for icons, images and layout.
* With `--json`, each entry in `lines` also has the line's box.

## Examples [#examples]

```sh
$ 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 [#mcp-tool]

[`find_text`](https://zeptap.com/docs/agents/tools#find_text). Flags are arguments.
