# Getting started — Rill Docs

Source: https://userill.dev/docs

Getting started

# Set up once. Ask your agent to record.

Install Rill, connect your account, and tell your agent what you want to test. Your agent handles the recording and brings back a shareable link.

Install

## Install Rill and ffmpeg.

You’ll need macOS or Linux, Node.js 22 or newer, and Google Chrome or Chromium. Run these commands in the environment where your agent works.

```sh
npm install --global @runalabs/rill-cli
```

Install ffmpeg so Rill can turn the browser run into a video. Choose the command for your operating system.

### macOS

```sh
brew install ffmpeg
```

Uses Homebrew.

### Debian / Ubuntu

```sh
sudo apt install ffmpeg
```

For other Linux distributions, use your package manager.

Connect

## Sign in and check your setup.

```sh
rill login
```

```sh
rill doctor
```

Login prints a link and device code. Open the link, sign in, and approve the connection. Then run doctor to check that your account, Chrome, and ffmpeg are ready.

If a check fails, follow its recovery instructions. For headless environments or Linux keyring setup, see [authentication in the CLI reference](https://userill.dev/docs/cli#authenticate).

Start recording

## Describe the flow. Get the evidence.

With setup complete, prompt your agent in plain language. Include the app URL and what you want it to check. No separate skill installation is required.

```
Use Rill to record the checkout flow at http://localhost:3000. Verify that adding an item to the cart and reaching checkout works, then give me the recording link and tell me what passed or failed.
```

For a bug you’re fixing:

```
Use Rill to record this bug before the fix, then record the same flow after the fix. Return both links and explain what changed.
```

Your agent starts the browser, performs the flow, and uploads the recording. Open the returned link to watch the run and inspect its console logs, network requests, and interaction timeline.

Use an agent with browser tools that can connect to an existing Chromium browser. For a reusable workflow, optionally save the [copyable agent instructions](https://userill.dev/docs/cli#agents) in your agent’s project instructions or skill setup.

Need individual commands, troubleshooting, or advanced setup? Open the [CLI reference](https://userill.dev/docs/cli).