agent-browser

# Browser Automation with agent-browser

Headless browser CLI by Vercel. Full upstream docs: [github.com/vercel-labs/agent-browser](https://github.com/vercel-labs/agent-browser)

## Installation

```bash
npm install -g agent-browser
agent-browser install                # Download Chromium
agent-browser install --with-deps    # With system dependencies (Linux)
# Optional: npx skills add vercel-labs/agent-browser
```

## Quick Start

```bash
agent-browser open <url>          # Navigate to page
agent-browser snapshot -i         # Get interactive elements with refs
agent-browser click @e1           # Click element by ref
agent-browser fill @e2 "text"     # Fill input by ref
agent-browser close               # Close browser
```

## Core Concept: Snapshot + Refs

Run `agent-browser snapshot -i` to get interactive elements tagged `@e1`, `@e2`, etc. Use these refs for all subsequent interactions. Re-snapshot after navigation or significant DOM changes. This yields **93% less context** than full-DOM approaches.

## When to Use

- Web scraping from JS-rendered / SPA pages
- Form automation and multi-step workflows
- Screenshot capture and visual verification
- E2E test generation and debugging
- Content capture from authenticated pages

## Key Commands

| Command | Purpose |
|---------|---------|
| `open <url>` | Navigate to URL |
| `snapshot -i` | Interactive elements with refs |
| `click @e1` | Click element |
| `fill @e2 "text"` | Clear + type into input |
| `get text @e1` | Extract element text |
| `wait --load networkidle` | Wait for SPA render |
| `screenshot <path>` | Save screenshot |
| `state save <file>` | Persist cookies/storage |
| `state load <file>` | Restore session |
| `eval "js"` | Run JavaScript |
| `record start <path>` | Start video recording |
| `record stop` | Stop recording |
| `--session <name>` | Isolate parallel sessions |
| `--headed` | Show browser window |

Run `agent-browser --help` for the full 60+ command reference.

## OrchestKit Integration