Agent Browser
Testing & Qualityagent-browserAgent Browser is an Agent Skill for testing & quality published in the x-cmd/x-cmd repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Browser automation via Chrome/Chromium CDP — open, snapshot, click, screenshot. For testing web apps, mobile layouts, and automated interactions without Playwright/Puppeteer.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/x-cmd/x-cmd/blob/HEAD/mod/skill0/lib/skill0/skills/agent-browser/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/agent-browser, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
agent-browser
Install
x env use agent-browser
npm install -g agent-browser
brew install agent-browser
agent-browser install # optional, skip if using existing Chrome
Connect to existing Chrome
"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" --remote-debugging-port=9222
agent-browser --cdp 9222 open <url>
Profile & multi-session
Use --profile /tmp/ab-default to authorize once and share across sessions.
Each new --user-data-dir triggers a Chrome auth prompt — reuse the default to avoid it.
agent-browser --profile /tmp/ab-default open <url> --session myapp-desktop --headed
agent-browser open <url> --session myapp-iphone14
agent-browser --session myapp-iphone14 set device "iPhone 14"
Session names are global — use <project>-<device> to avoid collisions across agents.
Sessions share the daemon but are fully isolated (cookies, cache, tabs).
Skills & common commands
agent-browser skills get core --full
agent-browser open <url> --session <name> --device "iPhone 14"
agent-browser snapshot -i
agent-browser click @e<id>
agent-browser screenshot
agent-browser close --all
Data accumulates — see CLEANUP.md for periodic cleanup.