agent-browser

Original：🇺🇸 English

Translated

Fast headless browser CLI for AI agents. Supports deterministic element selection via accessibility tree snapshots and refs (@e1, @e2).

10.4kinstalls

Added on2026-02-13

NPX Install

npx skill4agent add supercent-io/skills-template agent-browser

bash

npx skills add vercel-labs/agent-browser
# or
npm install -g agent-browser
agent-browser install

AI agents should use the snapshot + ref workflow for best results:

Navigate:
```
agent-browser open <url>
```
Snapshot:
```
agent-browser snapshot -i
```
(Returns tree with refs like @e1, @e2)

Interact:

agent-browser click @e1

or

agent-browser fill @e2 "text"

Command	Description
`open <url>`	Navigate to a URL
`snapshot`	Get accessibility tree with refs
`click <sel>`	Click element (by ref or CSS)
`fill <sel> <text>`	Clear and fill input
`screenshot [path]`	Take page screenshot
`close`	Quit browser session

Isolated Sessions: Use
```
--session <name>
```
to isolate cookies/storage.
Persistent Profiles: Use
```
--profile <path>
```
to persist login sessions.
Semantic Locators:
```
find role button click --name "Submit"
```
JavaScript Execution:
```
eval "window.scrollTo(0, 100)"
```

bash

# Optimal AI Workflow
agent-browser open example.com
agent-browser snapshot -i --json
# (AI parses refs)
agent-browser click @e2