Inspect what your app is doing while it runs

Follow live screenshots, logs, telemetry, and UI trees, and use the app's permitted tools to investigate the current session.

Investigate an issue while the app is still in the state that produced it. Follow incoming evidence in the player, inspect the visible UI, and use the connected app’s permitted tools to examine its current state.

The local player presents the visual evidence. The CLI provides tool discovery, filtering, invocation, and JSON output. App-provided tools depend on SDK configuration, guard, and policy. External monitoring provides platform UI operations and host evidence without an SDK connection.

Live evidence

The player can update a selected session as the host receives:

  • screenshots and playback frames;
  • logs, exceptions, lifecycle events, and sanitized network evidence;
  • trends and custom telemetry;
  • touch input and inferred gestures;
  • visual tree snapshots and bounded-node overlays;
  • annotations and captured artifacts;
  • App Graph exploration progress and linked test traces.

Scrubbing away from the end pauses live following. Use Go live to return to the newest evidence without reconnecting the app.

App tools

Externally monitored sessions do not expose SDK app tools. Use their available screenshots, native logs, telemetry, Files view, and visible UI automation. Add the SDK to enable app-internal tools, touch recording, and instrumented network evidence. An unavailable app-tool call is refused with capability_unavailable; it is not silently replaced by a different operation.

Remote tools are declared by the app SDK and filtered by the app’s active guard and policy. Start by listing the tools available in the connected session:

ansight app tools <session-id>

For a focused, machine-readable catalog and an exact call, use:

ansight app tools <session-id> --policy read --detail summary --json
ansight app call <session-id> <tool-id> --arguments-json '{}' --json

The browser and CLI do not bypass an unavailable, denied, or higher-risk tool. Write and critical operations require explicit authorization appropriate to the workflow.

Visual trees

Captured trees are shown as searchable hierarchies with node properties. Selecting a bounded node can overlay its geometry on the corresponding screenshot. Live semantic UI commands remain available through ansight ui for agents and tests.

Disconnected state

Recorded evidence remains reviewable after an app disconnects. Live app tools, simulator control, new screenshots, and sandbox browsing require an eligible live session and the corresponding SDK or external provider capability.