agent-browser

Automate browser navigation, interaction, and capture through the agent-browser CLI.

Updated Jun 28, 2026
One-click install
npx skills add https://github.com/AO-HyS/aohys.com --skill agent-browser-ao-hys
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agent-browser
Source: https://github.com/AO-HyS/aohys.com/tree/main/.agents/skills/agent-browser
Command: npx skills add https://github.com/AO-HyS/aohys.com --skill agent-browser-ao-hys

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires agent-browser, and includes references (resource) components.

What problem does it solve? Manually driving a browser to test pages, fill forms, capture screenshots, or extract content is slow and error-prone. This Skill lets an AI agent operate websites through the agent-browser CLI using compact element refs instead of parsing raw DOM. ## Core Features & Use Cases - Snapshot-and-Interact Workflow: Navigate to a URL, snapshot interactive elements as refs like @e1, then click, fill, select, and scroll using those refs, re-snapshotting after page changes. - Capture and Verification: Take full-page or annotated screenshots, save pages as PDF, record session videos, and diff snapshots or screenshots to verify changes. - Sessions and Authentication: Run isolated named sessions, persist cookies and storage state, and use an encrypted auth vault so credentials never appear in prompts. - Use Case: Test a staging login flow by opening the page, filling credentials from environment variables, submitting the form, waiting for the dashboard URL, and saving a screenshot as evidence. ## Quick Start Use the agent-browser skill to open https://example.com, snapshot the interactive elements, and take a full-page screenshot.

Frequently Asked Questions about agent-browser

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate browser interactions with agent-browser?▼

Open a URL with agent-browser open, run snapshot -i to get element refs like @e1, then use click, fill, select, or scroll with those refs. Re-snapshot after any navigation or DOM change because refs are invalidated when the page changes.

How do I fill and submit a web form from the command line?▼

Navigate to the form, snapshot with -i to discover field refs, then use agent-browser fill for text inputs, select for dropdowns, and check for checkboxes. Click the submit button and wait with --load networkidle to confirm the result.

Can agent-browser save login sessions for reuse?▼

Yes. After logging in, run agent-browser state save to persist cookies and storage, then state load in later runs. Alternatively use the auth vault with auth save and auth login so passwords stay encrypted and never appear in prompts.

Does agent-browser support parallel or isolated browser sessions?▼

Yes. Pass --session <name> to run isolated sessions with separate cookies, storage, and tabs, which is useful for concurrent scraping or A/B comparisons. Use session list to inspect active sessions and close each one when finished.

Why do I get a ref not found error in agent-browser?▼

Refs are invalidated whenever the page changes, such as after clicks that navigate, form submissions, or dynamic content loading. Run snapshot -i again to obtain fresh refs before interacting further.

Can agent-browser capture screenshots, PDFs, and video?▼

Yes. Use screenshot with --full or --annotate for images, pdf to save the page as PDF, and record start/stop to capture WebM video of the session. The diff command also compares snapshots or screenshots against baselines.