RUN

Run from anywhere.

Start browser jobs from your terminal, CI, or another agent. Choose Cloud, the Chrome browser on your device, or let rtrvr route the job.

Install from npm Open on GitHub

Cloud

Run away from your laptop in a managed browser.

Chrome

Use the signed-in browser already on your device.

Auto

Use Chrome when it is available and Cloud when it is not.

CLI (global)

bash

npm install -g @rtrvr-ai/cli

Programmatic API

bash

curl https://api.rtrvr.ai/agent

The CLI provides the rtrvr command. Programmatic callers can use the HTTP API directly.

1Authenticate

bash

rtrvr auth login

2Run your first task

CLI

rtrvr run "Extract the top 10 products and prices" --url https://example.com

3Explore

bash

# Scrape a page
rtrvr scrape --url https://example.com

# Check your capabilities
rtrvr capabilities

# Run diagnostics
rtrvr doctor

Pick where the browser should run. Use --target, or keep Auto when the same job should work across environments.

01--cloud

Cloud

Run in a managed browser away from your device. Best for public pages, scheduled jobs, and unattended work.

02--extension

Chrome

Use the signed-in Chrome browser on your device. Best for private apps, SSO, and internal tools.

03--target auto

Auto (default)

Use Chrome when it is available; fall back to Cloud when it is not. Best for portable jobs.

Auto routing

rtrvr run "task"

Chrome onlineRun in Chrome

No deviceRun in Cloud

The response includes routing metadata showing which mode was selected and whether fallback was applied:

json

{
  "metadata": {
    "selectedMode": "cloud",
    "fallbackApplied": true,
    "fallbackReason": "no extension devices online"
  }
}

bash

# Positional input
rtrvr run "Find the latest pricing for each plan" --url https://example.com

# From file
rtrvr run --input-file ./task.txt --url https://example.com --target cloud

# From stdin
echo "Summarize this page" | rtrvr run --url https://example.com

<input>

Task description (positional argument)

--input <text>

Task description (flag alternative)

--input-file <path>

Read task description from a file

--url <url>

Target URL(s) for the agent

--target <mode>default: auto

Routing mode: auto, cloud, or extension

--cloud

Shortcut for --target cloud

--extension

Shortcut for --target extension

--device-id <id>

Target a specific browser extension device

--schema-file <path>

JSON schema file for structured output

--json

Machine-readable JSON output

--no-stream

Disable real-time progress streaming

Use the authenticated HTTP API directly for programmatic cloud runs.

Create a Run

cURL

curl -X POST https://api.rtrvr.ai/agent \
  -H "Authorization: Bearer $RTRVR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": "Find latest headline and author",
    "urls": ["https://example.com"],
    "target": "auto"
  }'

Client Options

apiKey

Your rtrvr API key (rtrvr_...)

defaultTargetdefault: auto

Default routing mode

baseUrldefault: https://api.rtrvr.ai

Override the API base URL

mcpUrldefault: https://mcp.rtrvr.ai

Override the MCP base URL

Unified Run

JSON body

{
  "input": "Find latest headline and author",
  "urls": ["https://example.com"],
  "target": "auto"
}

Direct Tool Calls

CLI

rtrvr raw extract_from_tab --user_input "Extract all product names and prices" --tab_urls '["https://example.com/products"]'
rtrvr raw act_on_tab --user_input "Click the Sign Up button" --tab_urls '["https://example.com"]'
rtrvr raw crawl_and_extract_from_tab --user_input "Find all blog post titles" --tab_urls '["https://example.com/blog"]'

Scrape

CLI

rtrvr scrape https://example.com

Utilities

CLI

rtrvr devices
rtrvr credits
rtrvr profile

YOUR NEXT RUN