> ## 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.

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="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) |
| 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 | [API Quickstart](/api-reference/quickstart) |

## 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.
