Skip to content
Olef Docs

olef watch

CLI v3.0.2View Markdown

Generated from Olef 3.0.2. All commands · Capabilities and requirements

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.

olef watch

Section titled “olef watch”

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

Terminal window
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.