> ## Documentation Index
> Fetch the complete documentation index at: https://docs.revyl.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

Start, control, and debug Revyl cloud devices from the CLI.

You can use these devices without creating a Revyl test. See
[Device Infrastructure](/infrastructure) for custom harnesses, CI workflows,
and the Appium and Maestro connection requirements.

If you are new, start with [Device Quickstart](/cli/device/quickstart).

## Choose Your Path

<CardGroup cols={2}>
  <Card title="Device Quickstart" icon="rocket" href="/cli/device/quickstart">
    Learn the core session and action loop in minutes.
  </Card>

  <Card title="Auth And Session Prep" icon="key" href="/cli/device/auth-and-session-prep">
    How `session.before_script` and `session.auth_bypass` attach on `revyl
            device start`.
  </Card>

  <Card title="Live Observability" icon="chart-line" href="/cli/device/live-observability">
    Stream perf, network, and device logs live, and pull post-session artifacts.
  </Card>

  <Card title="Troubleshooting" icon="screwdriver-wrench" href="/cli/device/troubleshooting">
    Fix session, install, grounding, and action issues quickly.
  </Card>
</CardGroup>

## When To Use What

| Goal | Best Entry Point |
| - | - |
| First end-to-end run on a cloud device | [Device Quickstart](/cli/device/quickstart) |
| Signed-in starts via config (`session.before_script` / `session.auth_bypass`) | [Auth And Session Prep](/cli/device/auth-and-session-prep) |
| Full command-level control | [Command Reference](/cli/command-reference) |
| Agent-driven device control from IDE | [MCP Setup](/cli/mcp-setup) |
| CI orchestration of test and workflow runs | [CI/CD Integration](/guides/run-tests-ci-cd) |

## Core Ergonomics Loop

Whether you use CLI, SDK, or MCP, use the same reliable loop:

1. Take a screenshot or otherwise re-observe current state.
2. Choose one best action.
3. Verify the result immediately.
4. Repeat.

This avoids blind action chains and makes failures easier to debug.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.