How do I install the Agent Browser skill?

Run npx skillmds@latest add hjewkes/agent-browser in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Agent Browser safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Agent Browser?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Agent Browser free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Agent Browser?

hjewkes (@hjewkes) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Agent Browser by hjewkes — Agent Skill

Name: Agent Browser
Author: hjewkes

Agent Browser

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction.

hjewkes 013c06f 13 files · 46.5 KB Updated Sep 17, 2026

File contents

Browser Automation with agent-browser

Core Workflow

Every browser automation follows this pattern:

Navigate: agent-browser open <url>
Snapshot: agent-browser snapshot -i (get element refs like @e1, @e2)
Interact: Use refs to click, fill, select
Re-snapshot: After navigation or DOM changes, get fresh refs

agent-browser open https://example.com/form
agent-browser snapshot -i
# Output: @e1 [input type="email"], @e2 [input type="password"], @e3 [button] "Submit"

agent-browser fill @e1 "user@example.com"
agent-browser fill @e2 "password123"
agent-browser click @e3
agent-browser wait --load networkidle
agent-browser snapshot -i  # Check result

Essential Commands

# Navigation
agent-browser open <url>              # Navigate
agent-browser close                   # Close browser

# Snapshot
agent-browser snapshot -i             # Interactive elements with refs (recommended)
agent-browser snapshot -i -C          # Include cursor-interactive elements

# Interaction (use @refs from snapshot)
agent-browser click @e1               # Click
agent-browser fill @e2 "text"         # Clear and type
agent-browser select @e1 "option"     # Select dropdown
agent-browser check @e1               # Checkbox
agent-browser press Enter             # Key press

# Wait
agent-browser wait @e1                # Wait for element
agent-browser wait --load networkidle # Wait for network idle

# Capture
agent-browser screenshot              # Screenshot
agent-browser screenshot --full       # Full page

Ref Lifecycle (Important)

Refs (@e1, @e2, etc.) are invalidated when the page changes. Always re-snapshot after clicking links/buttons that navigate, form submissions, or dynamic content loading.

Deep-Dive Documentation

Reference	When to Use
references/commands.md	Full command reference with all options
references/snapshot-refs.md	Ref lifecycle, invalidation rules, troubleshooting
references/session-management.md	Parallel sessions, state persistence, concurrent scraping
references/authentication.md	Login flows, OAuth, 2FA handling, state reuse
references/video-recording.md	Recording workflows for debugging and documentation
references/proxy-support.md	Proxy configuration, geo-testing, rotating proxies
references/common-patterns.md	Form submission, auth, data extraction, parallel sessions, iOS simulator
references/semantic-locators.md	Alternatives to refs
references/javascript-evaluation.md	eval rules, --stdin/-b explanation

Ready-to-Use Templates

Template	Description
templates/form-automation.sh	Form filling with validation
templates/authenticated-session.sh	Login once, reuse state
templates/capture-workflow.sh	Content extraction with screenshots

---name: agent-browserdescription: Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction.---# Browser Automation with agent-browser## Core WorkflowEvery browser automation follows this pattern:1. **Navigate**: `agent-browser open <url>`2. **Snapshot**: `agent-browser snapshot -i` (get element refs like `@e1`, `@e2`)3. **Interact**: Use refs to click, fill, select4. **Re-snapshot**: After navigation or DOM changes, get fresh refs```bashagent-browser open https://example.com/formagent-browser snapshot -i# Output: @e1 [input type="email"], @e2 [input type="password"], @e3 [button] "Submit"agent-browser fill @e1 "user@example.com"agent-browser fill @e2 "password123"agent-browser click @e3agent-browser wait --load networkidleagent-browser snapshot -i # Check result```## Essential Commands```bash# Navigationagent-browser open <url> # Navigateagent-browser close # Close browser# Snapshotagent-browser snapshot -i # Interactive elements with refs (recommended)agent-browser snapshot -i -C # Include cursor-interactive elements# Interaction (use @refs from snapshot)agent-browser click @e1 # Clickagent-browser fill @e2 "text" # Clear and typeagent-browser select @e1 "option" # Select dropdownagent-browser check @e1 # Checkboxagent-browser press Enter # Key press# Waitagent-browser wait @e1 # Wait for elementagent-browser wait --load networkidle # Wait for network idle# Captureagent-browser screenshot # Screenshotagent-browser screenshot --full # Full page```## Ref Lifecycle (Important)Refs (`@e1`, `@e2`, etc.) are invalidated when the page changes. Always re-snapshot after clicking links/buttons that navigate, form submissions, or dynamic content loading.## Deep-Dive Documentation| Reference | When to Use ||-----------|-------------|| [references/commands.md](references/commands.md) | Full command reference with all options || [references/snapshot-refs.md](references/snapshot-refs.md) | Ref lifecycle, invalidation rules, troubleshooting || [references/session-management.md](references/session-management.md) | Parallel sessions, state persistence, concurrent scraping || [references/authentication.md](references/authentication.md) | Login flows, OAuth, 2FA handling, state reuse || [references/video-recording.md](references/video-recording.md) | Recording workflows for debugging and documentation || [references/proxy-support.md](references/proxy-support.md) | Proxy configuration, geo-testing, rotating proxies || [references/common-patterns.md](references/common-patterns.md) | Form submission, auth, data extraction, parallel sessions, iOS simulator || [references/semantic-locators.md](references/semantic-locators.md) | Alternatives to refs || [references/javascript-evaluation.md](references/javascript-evaluation.md) | eval rules, --stdin/-b explanation |## Ready-to-Use Templates| Template | Description ||----------|-------------|| [templates/form-automation.sh](templates/form-automation.sh) | Form filling with validation || [templates/authenticated-session.sh](templates/authenticated-session.sh) | Login once, reuse state || [templates/capture-workflow.sh](templates/capture-workflow.sh) | Content extraction with screenshots |

Frequently asked questions