Skip to main content
Revyl can spin up live device instances that are streamed to your browser called Sessions. Start a session from the dashboard, CLI/API, or Agents to use a real iOS or Android device. Use sessions to:
  • explore your app directly on a real device without installing anything locally
  • let agents validate live changes on device
  • power the dev loop to validate local changes on a cloud device
  • provide reviewers with live access to a specific build
  • enable designers to confirm the implemented experience against the intended design
Sessions come from many sources and feed into one live device instance

​
Starting a Session

Sessions can come from anywhere:

​
From the Dashboard

  1. Go to Sessions and click Start session
  2. Pick a platform (iOS or Android), device model, and OS version
  3. Optionally pick an App and its Build to pre-install. It starts from the page you came from, else the app’s default branch on Automatic.
  4. Set an idle timeout (5m, 15m, 30m, or 1h)
  5. Click Start session
The device boots and streams to your browser on both iOS and Android. Non-default device targets (specific models or OS versions) may take longer to provision. Tap, swipe, type, and interact with it like a real phone.

​
From an Agent via the CLI

Install the Agent Skill and ask your agent to Start a new session of your app using Revyl

​
Active Sessions

The sessions page shows all live sessions with real-time status, elapsed time, and an idle indicator. Sessions that sit idle for more than 2 minutes get flagged. You can stop any session from the list. Web sessions show Web · Chrome with a browser icon and the app name when available. The platform filter and the Overview device-time breakdown include Web; unrecognized platforms are never labeled Android.

​
Session History

Past sessions show device info, duration, source, user, and the branch/build selected when they started. Filter by app and branch; installing another artifact later does not rewrite the initial build. From here you can: Use All users above the session list to show only your sessions (Me) or a teammate’s. Choose Proof of changes from All sources to find adaptive report sessions across launch sources. You can combine it with the user, platform, and status filters. The user column shows the person or partner when available; otherwise, automated sessions show Proof of Changes, PR preview, or PR workflow. GitHub-triggered sessions show only the pull request number beneath that label when available. Sessions with no known person or automation show Unknown starter.