agent-browser

# Agent Browser Skill

Browser automation using the `agent-browser` CLI - a fast, headless browser automation tool for AI agents.

## Installation

```bash
npm install -g agent-browser
# or use with npx
npx agent-browser install
```

## Quick Start

```bash
# Navigate to a URL
agent-browser open https://example.com

# Get accessibility snapshot (shows refs like @e1, @e2)
agent-browser snapshot -i

# Click using ref from snapshot
agent-browser click @e2

# Type into an element
agent-browser fill @e3 "hello world"

# Take screenshot
agent-browser screenshot output.png
```

## Core Commands

### Navigation
```bash
agent-browser open <url>           # Navigate to URL
agent-browser back                 # Go back
agent-browser forward              # Go forward
agent-browser reload               # Reload page
```

### Interaction
```bash
agent-browser click <sel>          # Click element (or @ref)
agent-browser dblclick <sel>       # Double-click
agent-browser type <sel> <text>    # Type into element
agent-browser fill <sel> <text>    # Clear and fill
agent-browser press <key>          # Press key (Enter, Tab, Control+a)
agent-browser hover <sel>          # Hover element
agent-browser focus <sel>          # Focus element
agent-browser check <sel>          # Check checkbox
agent-browser uncheck <sel>        # Uncheck checkbox
agent-browser select <sel> <val>   # Select dropdown option
```

### Getting Information
```bash
agent-browser snapshot             # Accessibility tree with refs
agent-browser snapshot -i          # Interactive elements only
agent-browser snapshot -c          # Compact (no empty elements)
agent-browser get text <sel>       # Get element text
agent-browser get html <sel>       # Get element HTML
agent-browser get value <sel>      # Get input value
agent-browser get title            # Get page title
agent-browser get url              # Get current URL
```

### Capture
```bash
agent-browser screenshot [path]    # Take screenshot
agent-browser screenshot