--- name: agent-browser description: Browser automation CLI for AI agents. Use for web scraping, testing, screenshots, form filling, and headless browser interactions. license: Apache-2.0 compatibility: opencode --- ## Overview Headless browser automation via CLI. Supports sessions, snapshots (accessibility tree + refs), and semantic interaction. ## Quick Start ```bash agent-browser open example.com agent-browser snapshot -i # Get interactive tree with refs (@e1) agent-browser click @e2 # Click by ref agent-browser fill @e3 "hello" # Fill input agent-browser screenshot page.png agent-browser close ``` ## Core Commands - **Nav**: `open `, `back`, `forward`, `reload`, `close` - **Action**: `click `, `dblclick`, `type `, `fill`, `hover`, `focus`, `check`, `uncheck`, `select`, `drag`, `upload`, `press ` - **View**: `scroll `, `scrollintoview`, `screenshot [path]`, `pdf` - **Info**: `get text|html|value|attr|title|url|count|box ` - **Check**: `is visible|enabled|checked ` - **Wait**: `wait |`, `wait --text|--url|--load|--fn` ## Locators & Selectors **Recommended**: Use `@ref` from `snapshot` output. **Semantic**: `find role|text|label|placeholder|alt|title|testid ` **CSS/XPath**: `"#id"`, `".class"`, `"text=Submit"`, `"xpath=//button"` ## Snapshots (AI Vision) Returns accessibility tree. Use `-i` (interactive), `-c` (compact), `-d ` (depth). `agent-browser snapshot -i --json` -> JSON output with refs. ## Advanced Features **Sessions**: `agent-browser --session `, `session list` **Tabs**: `tab`, `tab new [url]`, `tab `, `tab close` **Network**: `network route [--abort|--body]`, `network requests` **Storage**: `cookies [set|clear]`, `storage local [set|clear]` **Debug**: `console`, `errors`, `highlight`, `trace start|stop`, `eval ` **Settings**: `set viewport|device|geo|offline|media` ## Optimal Workflow 1. `agent-browser open ` 2. `agent-browser snapshot -i --json` -> Parse tree, find target `@ref` 3. `agent-browser click @ref` or `fill @ref ` 4. Repeat snapshot to verify state. ## Setup ```bash npm install -g agent-browser && agent-browser install ```

agent-browser

Scan your own AI components