# Agent Browser

A skill that hands your agent a Rust-based headless browser: navigate, click, fill forms and snapshot pages through structured commands.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1200 installs · ★ 1039
- Author: am-will
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/am-will/codex-skills/tree/HEAD/skills/agent-browser/SKILL.md
- Updated: 2026-07-14
- HTML: https://affpapa.org/en/nevibecode/skills/am-will-agent-browser

## What it does

Agent Browser is a browser automation CLI the agent drives like any other command. Navigation, clicks, typing, extraction and screenshots go through `agent-browser open`, `click`, `fill` and `snapshot`. The core is written in Rust, with a Node.js fallback.

It works off snapshots and element refs. You take a snapshot, get a list of elements tagged with refs like `@e2`, then act on them. Refs stay stable for one page load and reset on navigation, so snapshot again after every move. Add `--json` for machine-readable output, `--headed` to watch the window while debugging.

For OAuth and logged-in sites the skill either connects to your running Chrome over CDP or keeps a separate session: `agent-browser --cdp 9222 open ...` reuses your existing profile, while `--session` persists cookies between runs. Installing needs `node` and `npm`. On Linux ARM64 the command may not resolve in PATH — call the binary by its full path inside the bin folder.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add am-will/codex-skills --skill agent-browser -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/agent-browser/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/agent-browser/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add am-will/codex-skills --skill agent-browser -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/agent-browser/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add am-will/codex-skills --skill agent-browser -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/agent-browser/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install am-will/codex-skills agent-browser
```

2. **Manually: put the files in place**
- File: `.github/skills/agent-browser/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add am-will/codex-skills --skill agent-browser -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/am-will/codex-skills --path skills/agent-browser
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/agent-browser/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add am-will/codex-skills --skill agent-browser -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/am-will/codex-skills/tree/HEAD/skills/agent-browser/SKILL.md

## When to use it
- walk through a site and pull structured data without clicking by hand
- fill in a form and submit it from the agent
- snapshot a page and locate the right element by ref
- log in through Google OAuth and keep working in that session
- capture a screenshot or PDF mid-task

## Example prompts
- Open example.com, take a snapshot and list the elements you can act on
- Fill field @e3 with test@example.com and click submit
- Connect to Chrome on port 9222 and open star-swap.com under my session

## Similar
- [setup-browser-cookies](https://affpapa.org/en/nevibecode/skills/setup-browser-cookies.md) — skill · 342 installs
- [browser](https://affpapa.org/en/nevibecode/skills/browser.md) — skill · 5900 installs
- [dev-browser](https://affpapa.org/en/nevibecode/skills/dev-browser.md) — skill · 2500 installs
- [browser-use](https://affpapa.org/en/nevibecode/skills/browser-use.md) — skill · 98200 installs
- [bb-browser-openclaw](https://affpapa.org/en/nevibecode/skills/bb-browser-openclaw.md) — skill · 672 installs
- [lightpanda](https://affpapa.org/en/nevibecode/skills/lightpanda.md) — skill · 1300 installs

From the same set: [am-will/codex-skills](https://affpapa.org/en/nevibecode/by/am-will/codex-skills.md) — 10 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md