agent-browser

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

6|2|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/Jerrylalala/compound-engineering --skill agent-browser-jerrylalala
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agent-browser
Source: https://github.com/Jerrylalala/compound-engineering/tree/main/plugins/compound-engineering/skills/agent-browser
Command: npx skills add https://github.com/Jerrylalala/compound-engineering --skill agent-browser-jerrylalala

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 Chrome/Chromium browser, so tasks like logging in, clicking through flows, capturing screenshots, and extracting page data can be fully automated. ## Core Features & Use Cases - Snapshot-and-Ref Interaction: Get compact accessibility snapshots with element refs (@e1, @e2) to click, fill, select, and scroll without parsing raw HTML. - Authentication & Session Management: Save and restore login state, use persistent profiles, encrypted auth vaults, and named sessions for parallel isolated browsing. - Capture & Verification: Take annotated screenshots, record video, save PDFs, diff page states, and profile performance with Chrome DevTools traces. - Use Case: Test a web app's signup flow by opening the page, snapshotting the form, filling fields by ref, submitting, and verifying the redirect — all from shell commands. ## 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 dashboard.

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 actions from the command line?▼

Use agent-browser to open a URL, run snapshot -i to get element refs like @e1, then click, fill, or select using those refs. Commands can be chained with && or batched via JSON for multi-step workflows.

How to fill out and submit a web form with agent-browser?▼

Open the form URL, run agent-browser snapshot -i to discover field refs, then use fill for text inputs, select for dropdowns, and check for checkboxes. Click the submit button ref and wait for navigation with wait --load networkidle.

How do I stay logged in between browser automation runs?▼

Save state after login with agent-browser state save auth.json and reload it with state load, or use --session-name for automatic cookie and localStorage persistence. The auth vault stores encrypted credentials so passwords never appear in commands.

Why does agent-browser report ref not found errors?▼

Refs are invalidated whenever the page changes through navigation, form submission, or dynamic content updates. Re-run agent-browser snapshot -i after any page change to obtain fresh refs before interacting again.

Can agent-browser run multiple isolated browser sessions?▼

Yes, use --session <name> to run parallel sessions with independent cookies, storage, cache, and tabs. List active sessions with agent-browser session list and close each with --session <name> close when finished.

Does agent-browser support browsers other than Chrome?▼

The default engine is Chrome/Chromium via CDP, and Lightpanda is supported as a faster headless alternative via --engine lightpanda. It also supports iOS Simulator Safari through Appium on macOS with Xcode installed.