Browser Automation
Use this skill when work requires real browser interaction instead of API-only lookups.
Core Workflow
- Open target page:
agent-browser open <url>
- Capture interactive refs:
agent-browser snapshot -i
- Interact by ref:
agent-browser click @e1agent-browser fill @e2 "value"
- Re-snapshot after every navigation or significant DOM change:
agent-browser snapshot -i
- Capture result evidence:
agent-browser screenshot --annotate <file.png>
Operational Rules
- Use
agent-browserdirectly; do not usenpx agent-browser. - Prefer one named session for multi-step flows:
agent-browser --session <name> ...
- Use chained commands with
&&only when no intermediate output is needed. - For commands that need refs (
@e*), runsnapshot -ifirst and use fresh refs. - If page load is async-heavy, wait explicitly:
agent-browser wait --load networkidle
- For user-facing findings, include screenshots and the exact page URL.
- When a user asks to see/share a screenshot in Slack, use
sendFileswith the screenshot path infilesso the image is included in the active conversation. - Never claim a screenshot was shared unless
sendFilesreturned success in this turn. - If
sendFilesis unavailable or file attachment fails, state the failure clearly and include the saved screenshot path or error instead of claiming success.
Common Patterns
Form flow
agent-browser --session demo open https://example.com/signup
agent-browser --session demo wait --load networkidle
agent-browser --session demo snapshot -i
agent-browser --session demo fill @e1 "user@example.com"
agent-browser --session demo click @e2
agent-browser --session demo wait --load networkidle
agent-browser --session demo screenshot --annotate /tmp/signup-result.png
Structured extraction
agent-browser open https://example.com
agent-browser snapshot --json > /tmp/page.json
agent-browser get text body > /tmp/page.txt
Reference Files
Read only what is needed:
- Command surface: references/commands.md
- Auth vault + login flows: references/authentication.md
- Session/state persistence: references/session-management.md
- Snapshot refs and stale-ref handling: references/snapshot-refs.md
- Proxy/network setup: references/proxy-support.md
- Recording and video capture: references/video-recording.md
- Performance profiling: references/profiling.md
Templates
- Authenticated flow bootstrap: templates/authenticated-session.sh
- Capture workflow skeleton: templates/capture-workflow.sh
- Form automation skeleton: templates/form-automation.sh