agent-browser

Automates browser navigation, form filling, scraping, and testing via the agent-browser CLI.

Updated May 22, 2026
One-click install
npx skills add https://github.com/viniciuscs84/sdd-toolkit --skill agent-browser-viniciuscs84
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-browser
Source: https://github.com/viniciuscs84/sdd-toolkit/tree/main/skills/agent-browser
Command: npx skills add https://github.com/viniciuscs84/sdd-toolkit --skill agent-browser-viniciuscs84

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Manually driving a browser for repetitive tasks like form submission, data extraction, login flows, and web app testing is slow and error-prone. This Skill gives an AI agent a structured command-line workflow to navigate pages, interact with elements via compact refs, capture screenshots, and manage authenticated sessions. ## Core Features & Use Cases - Snapshot-and-Interact Workflow: Take interactive snapshots that assign refs like @e1 to elements, then click, fill, select, and scroll using those refs, keeping context usage low. - Authentication & Session Management: Save credentials in an encrypted auth vault, persist cookies and localStorage across runs, and run isolated parallel sessions for concurrent scraping or testing. - Capture, Diffing & Debugging: Take full-page or annotated screenshots, export pages as PDF, record video, diff page states or screenshots, and profile performance with Chrome DevTools traces. - Use Case: Imagine you need to verify a signup flow on a staging site. Open the page, snapshot the form, fill each field by ref, submit, wait for the redirect, and diff the snapshot to confirm the success page rendered. ## Quick Start Use the agent-browser skill to open https://example.com/login, fill in the email and password fields, submit the form, and take a screenshot of the resulting page.

Frequently Asked Questions about agent-browser

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

FAQPage Schema
How do I automate form filling in a browser from the command line?

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

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

Save state after login with agent-browser state save auth.json, then restore it later with agent-browser state load. Alternatively, use the auth vault with agent-browser auth save and auth login so credentials stay encrypted and never appear in prompts.

Can agent-browser run multiple isolated browser sessions at once?

Yes, use the --session flag with distinct names to run parallel sessions with independent cookies, storage, cache, and tabs. List active sessions with agent-browser session list and close each one when finished.

Does agent-browser support mobile or iOS browser testing?

Yes, it supports Mobile Safari on iOS simulators via the -p ios flag with a device name, using tap, swipe, and fill commands. This requires macOS with Xcode and Appium with the xcuitest driver installed.

Why does agent-browser report a ref not found error?

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

How do I restrict which websites the browser automation can visit?

Set AGENT_BROWSER_ALLOWED_DOMAINS to a comma-separated allowlist of domains, which also blocks sub-resource requests to non-allowed origins. You can additionally gate actions with a JSON action policy file via AGENT_BROWSER_ACTION_POLICY.