agent-browser

Automate browser navigation, form filling, screenshots, and data extraction via a CLI.

Updated Apr 29, 2026
One-click install
npx skills add https://github.com/dev-khoi/AURA-conHack-2026 --skill agent-browser-dev-khoi
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agent-browser
Source: https://github.com/dev-khoi/AURA-conHack-2026/tree/main/.opencode/skills/agent-browser
Command: npx skills add https://github.com/dev-khoi/AURA-conHack-2026 --skill agent-browser-dev-khoi

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Manually interacting with websites for testing, scraping, or repetitive workflows is slow and error-prone. This Skill gives an AI agent full programmatic control of a real browser through a simple CLI, turning multi-step web tasks into deterministic command sequences. ## Core Features & Use Cases - Snapshot-and-Ref Interaction: Get compact accessibility-tree snapshots with element refs (@e1, @e2) to click, fill, select, and type without parsing raw HTML. - Authentication & Sessions: Reuse login state via auth vault, persistent profiles, session names, or state files, including OAuth and 2FA flows. - Capture & Verification: Take annotated screenshots, save PDFs, record video, diff page states, and inspect network requests for testing and debugging. - Use Case: Automate a login flow once, save the session state, then run a daily job that opens a dashboard, extracts table data, and saves a full-page screenshot as evidence. ## Quick Start Ask the agent to open a website, snapshot the page, fill in the login form, and take a screenshot of the result.

Frequently Asked Questions about agent-browser

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

FAQPage Schema
How do I automate filling out a web form from the command line?▼

Open the page with agent-browser open, run snapshot -i to get element refs, then use fill, select, and check commands with those refs before clicking submit. Re-snapshot after submission to verify the result.

How do I keep a browser session logged in between automation runs?▼

Save state after logging in with agent-browser state save, or use --session-name to auto-save and restore cookies and localStorage. The auth vault stores credentials encrypted so the password never appears in commands.

Can agent-browser connect to my existing Chrome browser?▼

Yes. Start Chrome with --remote-debugging-port=9222, then use agent-browser --auto-connect or --cdp 9222 to attach. This lets you reuse sites where you are already logged in.

Why do I get a ref not found error after clicking a button?▼

Refs are invalidated whenever the page changes, including navigation, form submissions, and dynamic content updates. Run snapshot -i again after any page change to get fresh refs before interacting.

Does agent-browser support mobile or iOS testing?▼

Yes. Use set device for desktop device emulation, or -p ios with --device to drive Mobile Safari on an iOS simulator. iOS support requires macOS with Xcode and Appium installed.

How do I handle JavaScript alert or confirm dialogs that block automation?▼

Alert and beforeunload dialogs are auto-accepted by default. For confirm and prompt dialogs, use agent-browser dialog accept or dialog dismiss, and check dialog status if commands start timing out.