agent-browser

1# Browser Automation with agent-browser
2 
3## Core Workflow
4 
5Every browser automation follows this pattern:
6 
71. **Navigate**: `agent-browser open <url>`
82. **Snapshot**: `agent-browser snapshot -i` (get element refs like `@e1`, `@e2`)
93. **Interact**: Use refs to click, fill, select
104. **Re-snapshot**: After navigation or DOM changes, get fresh refs
11 
12```bash
13agent-browser open https://example.com/form
14agent-browser snapshot -i
15# Output: @e1 [input type="email"], @e2 [input type="password"], @e3 [button] "Submit"
16 
17agent-browser fill @e1 "user@example.com"
18agent-browser fill @e2 "password123"
19agent-browser click @e3
20agent-browser wait --load networkidle
21agent-browser snapshot -i  # Check result
22```
23 
24## Command Chaining
25 
26Commands can be chained with `&&` in a single shell invocation. The browser persists between commands via a background daemon, so chaining is safe and more efficient than separate calls.
27 
28```bash
29# Chain open + wait + snapshot in one call
30agent-browser open https://example.com && agent-browser wait --load networkidle && agent-browser snapshot -i
31 
32# Chain multiple interactions
33agent-browser fill @e1 "user@example.com" && agent-browser fill @e2 "password123" && agent-browser click @e3
34 
35# Navigate and capture
36agent-browser open https://example.com && agent-browser wait --load networkidle && agent-browser screenshot page.png
37```
38…