# olef watch

Source: https://olef.dev/docs/reference/cli/watch

Generated from **Olef 3.0.2**. [All commands](https://olef.dev/docs/reference/commands) · [Capabilities and requirements](https://olef.dev/docs/reference/capabilities)

These entries describe available commands, not a sequence to run. Check prerequisites before changing app, device, or cloud state. Global options are listed in the [command catalog](https://olef.dev/docs/reference/commands#global-options).

## olef watch

Watch the app timeline: UI changes, crashes, toasts, watchers, and network events when available

```bash
olef watch --help
```

Output: **jsonl**.

| Argument | Description |
| --- | --- |
| `--app <APP>` | Only emit app-scoped events for this package. Permission dialogs are still allowed |
| `--poll-ms <POLL_MS>` | Safety-net poll interval (ms). Catches in-screen changes that emit no logcat transition — a counter ticking, async content loading — by re-dumping on this cadence. Navigation changes are caught immediately via logcat, independent of this; lower = notice silent changes sooner at the cost of more dumps Default: `1000`. |
| `--debounce-ms <DEBOUNCE_MS>` | Settle delay (ms) after a logcat transition before dumping, so a burst of transition events (an animation, a multi-step navigation) collapses into one dump of the final screen instead of every intermediate frame. Not applied to poll ticks or post-command refreshes Default: `80`. |
| `--no-stdin` | Don't read interactive commands from stdin; only stream events |
| `--no-crash-detect` | Don't parse logcat for crashes/ANRs (skip the crash watcher) |
| `--full` | Emit the full element set (bounds + every UIAutomator flag) instead of the compact agent shape — the same flag as `ui dump --full` |
| `--permission-dialogs <PERMISSION_DIALOGS>` | Built-in Android permission dialog policy Default: `ignore`. Values: `ignore`, `allow`, `deny`. |
| `--watcher-file <WATCHER_FILE>` | Load a JSON watcher-rules file (declarative popup auto-handlers). Repeatable to stack multiple rule files |
| `--no-net` | Do not try to attach live HTTP events from a running `net` proxy daemon |
| `--no-logpoints` | Do not stream logpoint hits from an attached debug session |
| `--heartbeat-ms <HEARTBEAT_MS>` | Emit `{"type":"heartbeat",…}` after this long without any other line, so a reader can tell an idle stream from a dead one. 0 turns heartbeats off Default: `15000`. |