agent-browser

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

1|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/Alwahdi/mikrotik-whisperer --skill agent-browser-alwahdi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-browser
Source: https://github.com/Alwahdi/mikrotik-whisperer/tree/main/.agents/skills/agent-browser
Command: npx skills add https://github.com/Alwahdi/mikrotik-whisperer --skill agent-browser-alwahdi

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? AI agents and scripts often need to interact with websites—logging in, filling forms, clicking buttons, or scraping content—but raw DOM parsing is slow and token-heavy. This Skill provides a CLI that drives Chrome via CDP with compact element refs, making web automation fast and context-efficient. ## Core Features & Use Cases - Snapshot-Based Interaction: Get interactive elements as compact refs (@e1, @e2) and click, fill, or select them directly, reducing token usage dramatically. - Authentication & Sessions: 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 extract text or structured data from any page. - Use Case: Automate an end-to-end test of a web app's signup flow—open the page, snapshot the form, fill fields by ref, submit, and verify the redirect to the dashboard. ## Quick Start Ask the agent to open a website, snapshot its interactive elements, 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 browser actions from the command line?

Install agent-browser via npm, brew, or cargo, then run agent-browser open <url> followed by agent-browser snapshot -i to get element refs. Use those refs with commands like click, fill, and select to interact with the page.

How do I fill out and submit a web form programmatically?

Open the form URL, run agent-browser snapshot -i to discover input refs, then use agent-browser fill @e1 "value" for each field and agent-browser click on the submit button. Wait with --load networkidle and re-snapshot to verify the result.

How do I stay logged in between browser automation runs?

Save state after logging in with agent-browser state save auth.json, then restore it later with state load. Alternatively use --session-name for automatic cookie persistence or the encrypted auth vault with agent-browser auth save and auth login.

Why do 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 agent-browser snapshot -i again after any action that modifies the DOM to get fresh refs.

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, and tabs. List active sessions with agent-browser session list and close each one when finished.

Does agent-browser support mobile device testing?

Yes, use agent-browser set device "iPhone 14" for viewport and user-agent emulation on desktop, or -p ios with a simulator UDID for real Mobile Safari automation via Appium on macOS with Xcode.