# Agent Browser

Automates websites through the agent-browser CLI: navigation, forms, screenshots, and data.

- Repository: https://github.com/sipeed/picoclaw (30078 stars)
- Category: AI and agents
- License: MIT
- Last updated: 2026-10-30
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add sipeed/picoclaw --skill agent-browser -g -a claude-code -y`
Codex: `npx skills add sipeed/picoclaw --skill agent-browser -g -a codex -y`
Cursor: `npx skills add sipeed/picoclaw --skill agent-browser -g -a cursor -y`
Gemini CLI: `npx skills add sipeed/picoclaw --skill agent-browser -g -a gemini-cli -y`

## Description

Browser automation via agent-browser CLI. Use when the user needs to navigate websites, fill forms, click buttons, take screenshots, extract data, or test web apps.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Agent Browser

CLI browser automation via Chrome/Chromium CDP. Install: `npm i -g agent-browser && agent-browser install`.

**Before using this skill**, verify the tool is available by running `which agent-browser`. If the command is not found, tell the user that browser automation requires the `agent-browser` CLI and Chromium, which are only available in the heavy container image. Do not attempt to install it at runtime.

## Core Workflow

1. `agent-browser open <url>`, navigate
2. `agent-browser snapshot -i`, get interactive elements with refs (`@e1`, `@e2`, ...)
3. Interact using refs, `click @e1`, `fill @e2 "text"`
4. Re-snapshot after any navigation or DOM change, refs are invalidated

```bash
agent-browser open https://example.com/form
agent-browser snapshot -i
# @e1 [input] "Email", @e2 [input] "Password", @e3 [button] "Submit"
agent-browser fill @e1 "user@example.com"
agent-browser fill @e2 "secret"
agent-browser click @e3
agent-browser wait --load networkidle
agent-browser snapshot -i
```

Chain commands with `&&` when you don't need intermediate output:
```bash
agent-browser open https://example.com && agent-browser wait --load networkidle && agent-browser snapshot -i
```

## Commands

```bash
# Navigation
agent-browser open <url>
agent-browser close

# Snapshot
agent-browser snapshot -i                # Interactive elements with refs
agent-browser snapshot -s "#selector"    # Scope to CSS selector

# Interaction (use @refs from snapshot)
agent-browser click @e1
agent-browser fill @e2 "text"            # Clear + type
agent-browser type @e2 "text"            # Type without clearing
agent-browser select @e1 "option"
agent-browser check @e1
agent-browser press Enter
agent-browser scroll down 500

# Get info
agent-browser get text @e1
agent-browser get url
agent-browser get title

The rest: https://github.com/sipeed/picoclaw/blob/HEAD/workspace/skills/agent-browser/SKILL.md