Watch an AI agent test a mobile app

Description and use

Tapflow’s watch page lets developers view AI agent actions on a mobile device live, enhancing debugging and test transparency.

Developers cannot observe an AI agent’s actions on a mobile device in real time while the agent is driving a simulator.

The watch page enables real‑time monitoring of AI‑driven mobile tests, improving visibility and debugging of timing and UI‑tree issues.

1. Run a flow with tapflow flow run or start MCP server. 2. The connect_device call returns a watchUrl. 3. Open the watchUrl in a browser. 4. Observe the live device screen and interaction list. 5. Review actions such as taps, swipes, text entry, app launches, and links as they happen.
6. Use the watch page to debug timing and UI‑tree issues by inspecting the live view and interaction log.

tapflow 0.28.0 adds a watch page for an MCP session.

connect_device returns a watchUrl, and opening it shows the device live in the dashboard.

The page is read-only, so clicking it does not send input to the device.

Up to four people can watch one session.

The page also shows an interaction list beside the device.

The blue cursor stays on the last tap, then glides to the next one.