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

# Command Reference

> Complete index of Browser-act CLI commands.

This page is a command index. Use the feature chapters for context, examples, and decision rules.

## Global options

> \[!NOTE]
> Global flags can be combined with command groups. Use `--session <name>` for browser interaction commands, `--format text|json` for output, `--no-auto-dialog` when dialogs should not be handled automatically, and `--version` to check the installed CLI.

| Option                | Description                                   |
| --------------------- | --------------------------------------------- |
| `--session <name>`    | Session name for browser interaction commands |
| `--format text\|json` | Output format                                 |
| `--no-auto-dialog`    | Disable automatic dialog handling             |
| `--version`           | Show CLI version                              |

## Goal-based lookup

| I want to...                   | Use                                                  | Read more                                                       |
| ------------------------------ | ---------------------------------------------------- | --------------------------------------------------------------- |
| Extract protected page content | `stealth-extract`                                    | [Anti-detection & Blocking](/agent-cli/anti-detection-blocking) |
| Create a stealth browser       | `browser create --type stealth ...`                  | [Browser Modes](/agent-cli/browser-modes)                       |
| Open a page and interact       | `browser open` -> `state` -> `click` / `input`       | [Quick Start](/agent-cli/quick-start)                           |
| Find API calls behind the UI   | `network requests` -> `network request <request_id>` | [Designed for Agents](/agent-cli/designed-for-agents)           |
| Handle CAPTCHA                 | `captcha-aid`, `solve-captcha`, `remote-assist`      | [Anti-detection & Blocking](/agent-cli/anti-detection-blocking) |
| Let a human take over          | `remote-assist --objective "..."`                    | [Remote Assist](/agent-cli/remote-assist)                       |
| Run multiple accounts          | separate browsers and named sessions                 | [Concurrency & Isolation](/agent-cli/concurrency-isolation)     |
| Reuse local login state        | `browser import-profile`                             | [Browser Modes](/agent-cli/browser-modes)                       |

## Command groups

<Columns cols={3}>
  <Card title="Browser interaction" icon="mouse-pointer-click" href="#browser-interaction-commands" cta="Open">
    Navigate pages, read state, click, type, extract, wait, capture network data, and manage tabs.
  </Card>

  <Card title="Browser management" icon="panel-top" href="#browser-management-commands" cta="Open">
    List, create, update, delete, open, and import browser profiles.
  </Card>

  <Card title="Sessions" icon="split" href="#session-management" cta="Open">
    List and close task workspaces.
  </Card>

  <Card title="Stealth extraction" icon="shield-check" href="#stealth-extraction" cta="Open">
    Extract protected content without opening a named session.
  </Card>

  <Card title="Authentication" icon="key-round" href="#authentication" cta="Open">
    Log in, poll device auth, set API keys, or clear credentials.
  </Card>

  <Card title="Skill and system" icon="layers" href="#skill-and-system" cta="Open">
    Load runtime-aware instructions, send feedback, and report logs.
  </Card>
</Columns>

## Browser interaction commands

These commands require `--session <name>`.

### Navigation

```text theme={null}
navigate <url> [--new-tab]
back
forward
reload
```

### Page state

```text theme={null}
state
screenshot [path] [--full]
```

`state` uses indexed markers:

* `[N]`: element index for commands such as `click N` or `input N "text"`
* `*[N]`: element is new or changed since the previous `state` call

### Interaction

```text theme={null}
click <index>
hover <index>
input <index> <text>
select <index> <option>
type <text>
keys <key_combo>
scroll up|down [--amount]
scrollintoview --selector <css>
upload <index> <path>
```

### Data extraction

```text theme={null}
get title
get html [--selector]
get text <index>
get value <index>
get markdown
```

### JavaScript

```text theme={null}
eval <js> [--stdin]
```

Use `eval` for complex extraction, page-local calculations, or fallback operations that are awkward through indexed interaction.

### Waiting

```text theme={null}
wait stable [--timeout]
wait selector <index> --state visible|hidden|attached|detached [--timeout]
wait selector --selector <css> --state visible|hidden|attached|detached [--timeout]
```

### Network

```text theme={null}
network requests [--filter] [--type] [--method] [--status] [--clear]
network request <request_id>
network clear
network offline on|off
network har start
network har stop [path]
```

Use network capture to inspect XHR requests, find API endpoints, debug authentication, or export HAR files.

### Tabs and dialogs

```text theme={null}
tab list
tab switch <tab_id>
tab close [tab_id]
dialog accept [text]
dialog dismiss
dialog status
```

### Cookies

```text theme={null}
cookies get [--url]
cookies set <name> <value> [--domain] [--path] [--secure] [--http-only]
cookies clear [--url]
cookies export <file>
cookies import <file>
```

### CAPTCHA and handoff

```text theme={null}
captcha-aid
solve-captcha
remote-assist [--objective]
```

| Command         | Purpose                                                |
| --------------- | ------------------------------------------------------ |
| `captcha-aid`   | Assist with CAPTCHA on the current page                |
| `solve-captcha` | Try automatic CAPTCHA solving on the current page      |
| `remote-assist` | Generate a live URL so a human can operate the browser |

## Browser management commands

These commands do not require a session unless noted by the command behavior.

```text theme={null}
browser list
browser open <id_or_url> [url_arg] [--headed] [--private] [--allow-restart-chrome]
browser create --type <chrome|chrome-direct|stealth> --name <name> --desc <description> [options]
browser update <browser_id> [options]
browser delete <browser_id>
browser regions
browser list-profiles
browser import-profile <browser_id> <profile_id> [--allow-restart-chrome]
```

### `browser create` options

```bash theme={null}
browser-act browser create \
  --type chrome|chrome-direct|stealth \
  --name "my-browser" \
  --desc "Purpose description" \
  --source-profile <profile_id> \
  --dynamic-proxy <region> \
  --custom-proxy <url> \
  --private true|false \
  --confirm-before-use
```

Option notes:

* `--source-profile` applies to `chrome` browsers.
* `--dynamic-proxy`, `--custom-proxy`, and `--private` apply to `stealth` browsers.
* `--confirm-before-use` marks a browser as sensitive so the agent should ask before opening it.

### `browser update` options

```bash theme={null}
browser-act browser update <browser_id> \
  --name "New name" \
  --desc "Replace the description" \
  --desc-append "Append to the description" \
  --dynamic-proxy <region> \
  --custom-proxy <url> \
  --no-proxy \
  --private true|false \
  --confirm-before-use|--no-confirm-before-use
```

## Session management

```text theme={null}
session list
session close [name]
```

## Stealth extraction

`stealth-extract` is independent. It does not require a session.

```bash theme={null}
browser-act stealth-extract <url>
browser-act stealth-extract <url> --content-type html|markdown
browser-act stealth-extract <url> --dynamic-proxy <region>
browser-act stealth-extract <url> --custom-proxy <proxy_url>
browser-act stealth-extract <url> --timeout 60
browser-act stealth-extract <url> --output ./result.md
```

## Authentication

```text theme={null}
auth login
auth poll
auth set <api_key>
auth clear
```

## Skill and system

```text theme={null}
get-skills core --skill-version <version>
get-skills advanced
get-skills main
report-log
feedback <message>
```

## Learn more

<Columns cols={2}>
  <Card title="Designed for Agents" icon="brain-circuit" href="/agent-cli/designed-for-agents" cta="Understand model">
    Learn why the command model is optimized for agents.
  </Card>

  <Card title="Quick Start" icon="rocket" href="/agent-cli/quick-start" cta="Run a loop">
    Combine commands into the first working browser loop.
  </Card>
</Columns>