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

# Cloud Browsers for Stably CLI

> Run Stably's browser-backed CLI commands in Stably-hosted cloud browsers.

## Overview

You can run Stably CLI browser-backed commands in cloud browsers. This is especially useful in CI, and each subagent gets its own isolated browser session automatically.

<Callout icon="zap" color="#FFC107" iconType="regular">
  Useful when you:

  * Don't want to manage browser infra
  * Want to parallelize commands like `stably create` and `stably fix` to run faster
</Callout>

## Supported Commands

Cloud browser mode applies to the browser-backed agent commands:

* `stably`
* `stably create`
* `stably fix`
* `stably verify`

It does **not** change how `stably test` works. Normal Playwright test execution still runs in your own environment.

## How to Enable It

Use either the CLI flag or the environment variable:

```bash theme={null}
# Per command
stably --browser=cloud
stably create "test checkout" --browser=cloud
stably fix --browser=cloud
stably verify "signup works" --browser=cloud
```

```bash theme={null}
# For the current shell / CI job
export STABLY_CLOUD_BROWSER=1

stably create "test checkout"
stably fix
stably verify "signup works"
```

You can use `--browser=cloud` on the root command or the subcommand. These are equivalent:

```bash theme={null}
stably --browser=cloud create "test checkout"
stably create "test checkout" --browser=cloud
```

## Limits

* Cloud browser mode is for browser-backed agent commands, not `stably test`
* The browser is remote, but your filesystem is still local to the machine running the CLI
* `stably fix` still requires a git repository because fixes are applied to local files

<CardGroup cols={2}>
  <Card title="CLI Commands" icon="terminal" href="/stably-cli/commands">
    See the full command reference and shared global options.
  </Card>

  <Card title="Create Tests" icon="wand-magic-sparkles" href="/stably-cli/create">
    Use cloud browsers during test generation.
  </Card>

  <Card title="Fix Tests" icon="wrench" href="/stably-cli/fix">
    Run autofix in a remote browser while editing your local repo.
  </Card>

  <Card title="Verify with AI Agents" icon="circle-check" href="/use-cases/verify-with-ai-agents">
    Use `stably verify` with a cloud browser.
  </Card>
</CardGroup>