chrome-use

chrome-use

Fast browser automation CLI for AI agents. Chrome/Chromium via CDP with accessibility-tree snapshots and compact @eN element refs.

Install / self-heal: if the chrome-use (or abs) command is missing — e.g. a command errors with "command not found" — install it from the GitHub Release (no npm, no token), then retry. Do NOT fall back to other browser tools:

curl -fsSL https://raw.githubusercontent.com/leeguooooo/chrome-use/main/install.sh | sh

Start here

This file is a discovery stub, not the usage guide. Before running any chrome-use command, load the actual workflow content from the CLI:

chrome-use skills get core             # start here — workflows, common patterns, troubleshooting
chrome-use skills get core --full      # include full command reference and templates

The CLI serves skill content that always matches the installed version, so instructions never go stale. The content in this stub cannot change between releases, which is why it just points at skills get core.

Route to a specialized skill by symptom

Load a specialized guide when the task falls outside plain browser web pages. Match on the situation you're in, then run the command — the binary serves the full, version-matched content:

What you're hitting	Run
An element is clearly on screen but snapshot/find returns no @ref (canvas/WebGL/game/map)	chrome-use skills get canvas
Mock an API response, rewrite request headers, block a URL, record HAR	chrome-use skills get network
Debug React renders/state, or measure LCP/CLS/INP	chrome-use skills get react
Drive the user's real, already-logged-in Chrome (reuse the session)	chrome-use skills get real-chrome
Parallel sessions, multiple accounts, recover a stuck tab	chrome-use skills get sessions
Turn manual checks into a re-runnable regression suite	chrome-use skills get test
Electron desktop apps (VS Code, Slack, Discord, Figma, …)	chrome-use skills get electron
Slack workspace automation	chrome-use skills get slack
Exploratory testing / QA / bug hunt	chrome-use skills get dogfood
chrome-use inside Vercel Sandbox microVMs	chrome-use skills get vercel-sandbox
AWS Bedrock AgentCore cloud browsers	chrome-use skills get agentcore

Run chrome-use skills list to see everything available on the installed version.

Why chrome-use

• Fast native Rust CLI, not a Node.js wrapper
• Works with any AI agent (Cursor, Claude Code, Codex, Continue, Windsurf, etc.)
• Chrome/Chromium via CDP with no Playwright or Puppeteer dependency
• Accessibility-tree snapshots with element refs for reliable interaction
• Sessions, authentication vault, state persistence, video recording
• Specialized skills for Electron apps, Slack, exploratory testing, cloud providers

Observability Dashboard

The dashboard runs independently of browser sessions on port 4848 and can also be opened through a proxied or forwarded URL such as https://dashboard.chrome-use.localhost. Agents should stay on the dashboard origin: session tabs, status, and stream traffic are proxied internally, so session ports do not need to be exposed.