Quickstart

Pick the path that matches how you work. Each one runs your app in a cloud session, in a Web browser or on a mobile simulator or emulator, and leaves evidence you can open in Revyl. Web is in alpha. To add it to your organization, email [email protected]. Each path starts with its own setup prompt for your coding agent.

Choose a path

Prove a PR
Use the CLI
Write a test
Explore

Revyl opens each pull request’s build in a session, exercises the changed behavior, and posts a verdict on the PR. It works for Web, iOS, and Android apps, and it’s the fastest way to see Revyl work on your own code.

Install the Revyl GitHub App

In the dashboard, open Integrations → GitHub and install the app on your repository. From a terminal, revyl github connect does the same.

Configure a project root

Select the repository and configure its first project root: how each pull request is built for Web, iOS, or Android, and the app that receives each build. New project roots turn on proof of changes with the Revyl agent. From a terminal, run revyl github setup in your project instead.

Open a pull request

Revyl opens the pull request’s build in a session, and an agent exercises what the pull request changed.

Read the verdict

One comment on the pull request carries the verdict, a verification confidence score, screenshots, and a link to the session recording. Cloud Agents → Proof of Changes lists your organization’s proof runs.

Next: Proof of changes covers verdicts, sign-in, and which agent runs the proof. GitHub covers project roots and build profiles. On GitLab, follow the GitLab tutorial.

The CLI gives you and your coding agent the same access: run your app in a cloud session, check what it does, query Atlas, and create and run tests.

Install the CLI

curl -fsSL https://revyl.com/install.sh | sh

Or use brew, pipx, uv, or pip. See CLI install.

Authenticate and initialize

revyl auth login
revyl init

revyl init creates a .revyl/ directory with your project config and offers to install agent skills for your coding agent.

Run your app in a cloud session

revyl dev

For iOS and Android, the dev loop installs your development build on a cloud simulator or emulator and reloads it as you edit. See the Dev Loop guide. For a Web app, follow the Web guide and run revyl device start --platform web.

Hand it to your agent

Open your project in Cursor, Claude Code, Codex, or another coding agent and prompt it with something like:

Revyl is installed. Start the dev loop, check that the login flow
works on the device, and fix anything that doesn't.

The agent uses the CLI to start sessions, interact with your app, and validate what it sees.

Next: connect a client with MCP setup, write your first test from the CLI, or browse the full command reference.

Great for anyone turning a critical flow into a repeatable check.

Create an app

Head to Apps, click Create app, give it a name, and pick Web, iOS, or Android. Add a build:

Web: a deployed HTTPS URL, or a bundle Revyl builds. See Web builds
iOS: simulator .app bundle (from Xcode with "simulator": true)
Android: .apk or .zip containing an .apk

Or connect Expo to auto-sync every EAS build. See Apps, or the framework guides for platform-specific build instructions.

Create a test

Go to Tests, click Create test, give it a name, and pick the app you just created.

Add steps

In the test editor, add natural-language steps:

Instruction: “Tap the Sign In button”
Validation: “The home screen is visible”
Extraction: “Save the order number to {{order_id}}”

Run it

Click Run Steps. The device boots and the AI agent executes each step against your app.

Read the report

Every run produces a report: pass/fail, video replay, step-by-step results, device logs, network traces, and an AI-generated summary.

Next: learn about step types, modules, and workflows to group tests together.

Get started

Atlas

Agents

Runtime

Tests

Builds

Frameworks

Integrations

Partners

Security and network

Choose a path

Keep going

Core concepts

Atlas

​Choose a path

​Keep going

Core concepts

Atlas

Choose a path

Keep going