agent-browser

---
name: agent-browser
description: Automate websites with the agent-browser CLI for navigation, form flows, screenshots, extraction, and repeatable browser tasks. Use when users ask to interact with web apps, gather evidence from pages, or run browser-based QA steps.
---

# Browser Automation

Use this skill when work requires real browser interaction instead of API-only lookups.

## Core Workflow

1. Open target page:

- `agent-browser open <url>`

2. Capture interactive refs:

- `agent-browser snapshot -i`

3. Interact by ref:

- `agent-browser click @e1`
- `agent-browser fill @e2 "value"`

4. Re-snapshot after every navigation or significant DOM change:

- `agent-browser snapshot -i`

5. Capture result evidence:

- `agent-browser screenshot --annotate <file.png>`

## Operational Rules

- Use `agent-browser` directly; do not use `npx 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*`), run `snapshot -i` first 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 `sendFiles` with the screenshot path in `files` so the image is included in the active conversation.
- Never claim a screenshot was shared unless `sendFiles` returned success in this turn.
- If `sendFiles` is 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

```bash
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

```bash
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](references/commands.md)
- Auth vault + login flows: [references/authentication.md](references/authentication.md)
- Session/state persistence: [references/session-management.md](references/session-management.md)
- Snapshot refs and stale-ref handling: [references/snapshot-refs.md](references/snapshot-refs.md)
- Proxy/network setup: [references/proxy-support.md](references/proxy-support.md)
- Recording and video capture: [references/video-recording.md](references/video-recording.md)
- Performance profiling: [references/profiling.md](references/profiling.md)

## Templates

- Authenticated flow bootstrap: [templates/authenticated-session.sh](templates/authenticated-session.sh)
- Capture workflow skeleton: [templates/capture-workflow.sh](templates/capture-workflow.sh)
- Form automation skeleton: [templates/form-automation.sh](templates/form-automation.sh)

From getsentry/junior at 1745a29, shown as plain text under its license: Apache-2.0 (permissive). The license text is in LICENSE.

• SKILL.md3.2 KB · 65b640a61a68
• references/
• authentication.md5.0 KB · cd56ddc957da
• commands.md9.8 KB · cc6cc1780bb8
• profiling.md3.4 KB · 15f1e6c7994d
• proxy-support.md5.0 KB · 4c44ba60d939
• session-management.md4.3 KB · 2ce531bf105a
• snapshot-refs.md4.3 KB · edfb3fd87f9c
• video-recording.md3.6 KB · c2c12bd8c44e
• templates/
• authenticated-session.sh3.7 KB · 1fa9926c36db
• capture-workflow.sh1.8 KB · bf3f3a2f8413
• form-automation.sh1.8 KB · b86836986d33

11 files, 46 KB in total. Each file has a sha256 in the pin's manifest; the first 12 characters are shown.