mobilerun-viewer

Native desktop viewer for Mobilerun cloud devices. Renders the live WebRTC stream of a cloud-hosted phone in a desktop window with system nav buttons (BACK / HOME / RECENTS) and a side panel that shows every tool call (tap, swipe, press, …) in real time.

Reuses the same credential as the mobilerun CLI — read from MOBILERUN_API_KEY or the file mobilerun login writes — so authenticating in either command works for both.

Install

uv tool install mobilerun-viewer
# or:
pip install mobilerun-viewer

Use

# Discover your devices via the main CLI:
mobilerun devices --cloud

# Open the viewer:
mobilerun-viewer -d <device-id>

# Against a non-default API base (dev / staging):
mobilerun-viewer -d <device-id> --base-url https://dev-api.mobilerun.ai/v1

# Track an agent's task trajectory in the events panel:
mobilerun-viewer -d <device-id> --task-id <task-id>

If the main mobilerun CLI is installed alongside this package, the same viewer is also reachable as mobilerun stream ….

Flags

• -d, --device-id (required) — cloud device id.
• --base-url — Mobilerun API base; default https://api.mobilerun.ai/v1.
• --task-id — task whose trajectory feeds the events panel. Defaults to the device's activeTaskId if one is running.
• --no-window — don't open a desktop window; just print the local viewer URL (useful for debugging).