agent-browser

Automate browser interactions via CLI with ref-based element selection.

10|Updated Feb 15, 2026
One-click install
npx skills add https://github.com/aimi-so/aimi-engineering-plugin --skill agent-browser-aimi-so
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agent-browser
Source: https://github.com/aimi-so/aimi-engineering-plugin/tree/main/plugins/aimi-engineering/skills/agent-browser
Command: npx skills add https://github.com/aimi-so/aimi-engineering-plugin --skill agent-browser-aimi-so

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates web interactions via a CLI for AI agents, reducing manual browsing time and ensuring repeatable workflows.

Core Features & Use Cases

  • Headless browser automation using a CLI with ref-based element selection.
  • Navigate, snapshot accessibility trees, and interact via element refs to fill forms, click buttons, take screenshots, and scrape data.
  • Use cases include automated data collection, form submission, testing workflows, and repeatable web-based tasks.

Quick Start

Open a webpage, snapshot the interactive elements, fill a form, and click a button to complete a task.

Frequently Asked Questions about agent-browser

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

FAQPage Schema
How do I automate web scraping using a CLI browser tool?

You can automate web scraping using a CLI browser tool by navigating to a target URL, snapshotting the page's accessibility tree, and interacting with elements via refs to extract data. This approach provides repeatable workflows for automated data collection.

What is ref-based element selection in browser automation?

Ref-based element selection in browser automation is a method where interactive elements on a page are identified by accessible references rather than CSS selectors. You snapshot the accessibility tree to generate these refs, then use them to click or fill forms.

Can I fill out and submit web forms automatically from the command line?

Yes, you can fill out and submit web forms automatically from the command line. By opening a webpage and snapshotting interactive elements, you can use their refs to input data into form fields and click submission buttons.

Does this CLI browser automation tool require any external dependencies?

No, this CLI browser automation tool does not require any external dependencies. It operates independently to provide headless browser interactions for AI agents without needing additional packages or libraries.

What is the best way to capture screenshots during automated web navigation?

The best way to capture screenshots during automated web navigation is using a CLI command that takes a snapshot of the current page state. This allows you to visually verify the results of your automated browser interactions.

When should I not use a CLI-based approach for browser automation?

You should not use a CLI-based approach for browser automation when you need visual IDE-driven test recording or complex DOM querying via CSS selectors. This tool relies on accessibility tree snapshots and ref-driven interactions, which may not suit visually intensive workflows.