agent-browser

1# Browser Automation with agent-browser
2 
3## Quick start
4 
5```bash
6agent-browser open <url>        # Navigate to page
7agent-browser snapshot -i       # Get interactive elements with refs
8agent-browser click @e1         # Click element by ref
9agent-browser fill @e2 "text"   # Fill input by ref
10agent-browser close             # Close browser
11```
12 
13## Core workflow
14 
151. Navigate: `agent-browser open <url>`
162. Snapshot: `agent-browser snapshot -i` (returns elements with refs like `@e1`, `@e2`)
173. Interact using refs from the snapshot
184. Re-snapshot after navigation or significant DOM changes
19 
20## Commands
21 
22### Navigation
23 
24```bash
25agent-browser open <url>      # Navigate to URL
26agent-browser back            # Go back
27agent-browser forward         # Go forward
28agent-browser reload          # Reload page
29agent-browser close           # Close browser
30```
31 
32### Snapshot (page analysis)
33 
34```bash
35agent-browser snapshot            # Full accessibility tree
36agent-browser snapshot -i         # Interactive elements only (recommended)
37agent-browser snapshot -c         # Compact output
38agent-browser snapshot -d 3       # Limit depth to 3
39agent-browser snapshot -s "#main" # Scope to CSS selector
40```
41 
42### Interactions (use @refs from snapshot)
43 
44```bash
45agent-browser click @e1           # Click
46agent-browser dblclick @e1        # Double-click
47agent-browser fill @e2 "text"     # Clear and type
48agent-browser type @e2 "text"     # Type without clearing
49agent-browser press Enter         # Press key
50…