automating-browser

# Browser Automation (agent-browser)

## Core Commands

| Command                              | Purpose                         |
| ------------------------------------ | ------------------------------- |
| `agent-browser --headed open <url>`  | Open URL (visible browser)      |
| `agent-browser open <url>`           | Open URL (headless)             |
| `agent-browser snapshot -i`          | Get interactive elements (refs) |
| `agent-browser click @ref`           | Click element                   |
| `agent-browser fill @ref "text"`     | Clear and fill                  |
| `agent-browser type @ref "text"`     | Type into element               |
| `agent-browser press <key>`          | Press key (Enter, Tab, etc.)    |
| `agent-browser get text @ref`        | Read element text               |
| `agent-browser wait <sel\|ms>`       | Wait for element or time        |
| `agent-browser find <loc> <val> <a>` | Find by role/text/label + act   |
| `agent-browser screenshot [path]`    | Capture screenshot              |
| `agent-browser close`                | Close browser session           |

## Debugging Commands

| Command                                       | Purpose                    |
| --------------------------------------------- | -------------------------- |
| `agent-browser console`                       | Display console output     |
| `agent-browser errors`                        | Show JS error stack traces |
| `agent-browser network requests`              | List captured requests     |
| `agent-browser network requests --filter api` | Filter by keyword          |
| `agent-browser trace start <path>`            | Begin recording trace      |
| `agent-browser trace stop`                    | Save trace file            |

## Workflow

| Step | Action                              |
| ---- | ----------------------------------- |
| 1    | `agent-browser --headed open <url>` |
| 2    | `agent-browser snapshot -i`         |
| 3    | Use `@ref` for operations