agent-browser

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

Updated Apr 4, 2026
One-click install
npx skills add https://github.com/AkaraChen/proxy-up --skill agent-browser-akarachen
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agent-browser
Source: https://github.com/AkaraChen/proxy-up/tree/main/.agents/skills/agent-browser
Command: npx skills add https://github.com/AkaraChen/proxy-up --skill agent-browser-akarachen

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 form entry is slow and error-prone. This Skill gives AI agents a command-line interface to control a real browser, so tasks like logging in, clicking through flows, and capturing page content can be fully automated. ## Core Features & Use Cases - Snapshot-and-Interact Workflow: Get compact accessibility snapshots with element refs (@e1, @e2), then click, fill, select, and scroll using those refs instead of fragile CSS selectors. - Authentication & Session Management: Save and restore login state, use persistent profiles, named sessions, or an encrypted auth vault so credentials never appear in prompts. - Capture & Verification: Take screenshots (including annotated and full-page), record video, save PDFs, and diff page states to verify that actions had the intended effect. - Use Case: Imagine you need to test a signup flow across staging and production. Open each URL, fill the form via refs, submit, then run a visual diff to confirm both environments behave identically. ## Quick Start Ask the agent to open a website with agent-browser, take an interactive snapshot, and fill out and submit the login form using the discovered element refs.

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 the submit button. Re-snapshot after submission to verify the result.

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

Save cookies and storage with agent-browser state save after logging in, then restore them with state load in later runs. Alternatively use --session-name for automatic save and restore, or the auth vault for encrypted credential storage.

Can agent-browser connect to an existing Chrome instance?▼

Yes, use --auto-connect to discover a running Chrome with remote debugging enabled, or --cdp 9222 to connect to a specific DevTools port. This lets you reuse an already-authenticated browser session.

Why do my element refs stop working after clicking a button?▼

Refs are invalidated whenever the page changes, including navigation, form submissions, and dynamic content updates. Always run snapshot -i again after any action that modifies the page to get fresh refs.

Does agent-browser support mobile or iOS testing?▼

Yes, it supports iOS Simulator via the -p ios flag with Appium and Xcode on macOS, including tap and swipe gestures. It also supports device emulation with set device for viewport and user agent simulation on desktop.

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

Alert and beforeunload dialogs are auto-accepted by default, while confirm and prompt require explicit handling. Use dialog status to check for a pending dialog, then dialog accept or dialog dismiss to resolve it.