Introduction
# Agent Browser Skill (Core)
## Purpose Provide an advanced, production-ready playbook for using agent-browser to automate web tasks via CLI and structured commands.
## Best fit - You need deterministic automation for AI agents. - You want compact snapshots with refs and JSON output. - You prefer a fast CLI with Node.js fallback.
## Not a fit - You require a full SDK or custom JS integration. - You must stream large uploads or complex media workflows.
## Quick orientation - Read `references/agent-browser-overview.md` for install, architecture, and core concepts. - Read `references/agent-browser-command-map.md` for command categories and flags. - Read `references/agent-browser-safety.md` for high-risk controls and safe mode rules. - Read `references/agent-browser-workflows.md` for recommended AI workflows. - Read `references/agent-browser-troubleshooting.md` for common issues and fixes.
## Required inputs - Installed agent-browser CLI and browser runtime. - Target URLs and workflow steps. - Session or profile strategy if authentication is required.
## Expected output - A clear command sequence and operational guardrails for automation.
## Operational notes - Snapshot early, act via refs, then snapshot again after DOM changes. - Use `--json` for machine parsing and scripting. - Use waits and load-state checks before actions. - Close tabs or sessions when done to release resources.
## Safe mode defaults - Do not use `eval`, `--allow-file-access`, custom `--executable-path`, or arbitrary `--args` without explicit approval. - Avoid `network route`, `set credentials`, and cookie/storage mutations unless the task requires it. - Allowlist domains and block localhost or private network targets.
## Security notes - Treat tokens and credentials as secrets. - Avoid `--allow-file-access` unless explicitly required.