Labsco
getsentry logo

agent-browser

✓ Official★ 276

by getsentry · part of getsentry/junior

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.

🧰 Not standalone. This skill ships with getsentry/junior and only works together with that tool — install the tool first, then add this skill.

This is the playbook your agent receives when the skill activates — you don't need to read it to use the skill, but it's here to audit before installing.

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>
  1. Capture interactive refs:
  • agent-browser snapshot -i
  1. Interact by ref:
  • agent-browser click @e1
  • agent-browser fill @e2 "value"
  1. Re-snapshot after every navigation or significant DOM change:
  • agent-browser snapshot -i
  1. 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 sendMessage with the screenshot path in files so the image is included in the active conversation.
  • Never claim a screenshot was shared unless sendMessage returned success in this turn.
  • If sendMessage 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

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:

Templates