# Agent Browser

> Browser automation via agent-browser CLI for web navigation, form filling, screenshots, scraping, login flows, and UI testing. Use when this capability is needed.

- Skill: `tomevault-io/agent-browser-21` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/agent-browser-21`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/agent-browser-21/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/agent-browser-21

---


# Agent Browser

Automate browser interactions through the `agent-browser` CLI for repeatable, scriptable web tasks.

## Instructions

1. Install and initialize the CLI.
2. Open the target URL and capture a snapshot.
3. Interact with elements using snapshot references.
4. Re-snapshot after navigation or state changes.
5. Export results (screenshots or JSON) for downstream use.

## Quick Reference

| Task | Action |
|------|--------|
| Install | `npm install -g agent-browser` then `agent-browser install` |
| Open page | `agent-browser open <url>` |
| Snapshot | `agent-browser snapshot -i --json` |
| Interact | `click @eN`, `fill @eN "text"` |
| Screenshot | `agent-browser screenshot output.png` |
| Docs | See `references/quick-start.md` |

## Input Requirements

- Target URL(s)
- CLI installed and Chromium downloaded
- Credentials if login is required

## Output

- Screenshots (PNG)
- JSON snapshots of page structure
- Extracted text/attributes

## Quality Gates

- [ ] Snapshot captured after each major navigation step
- [ ] Interactions verified in a follow-up snapshot
- [ ] Outputs saved to disk with clear filenames

## Examples

### Example 1: Capture a page snapshot

```bash
agent-browser open https://example.org
agent-browser snapshot -i --json > page.json
```

## Troubleshooting

**Issue**: Chromium not installed
**Solution**: Run `agent-browser install` (add `--with-deps` on Linux).

**Issue**: Element not found
**Solution**: Re-snapshot and confirm the correct element reference.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/fmschulz) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->