← ClaudeAtlas

chrome-cdp-setuplisted

Set up Google Chrome on macOS to always launch with the Chrome DevTools Protocol enabled (127.0.0.1:9222) via a Dock launcher app, so local AI agents (Playwright, Puppeteer, browser-use, OpenClaw) can drive the real logged-in browser. Use when the user wants to enable a CDP/remote-debugging port for Chrome, connect an agent to Chrome, test a CDP connection, or troubleshoot/revert an existing Chrome-CDP Dock setup.
soulmachine/skills · ★ 3 · DevOps & Infrastructure · score 74
Install: claude install-skill soulmachine/skills
# Chrome CDP Setup (macOS Dock launcher) Makes the Dock's Chrome icon launch Chrome with `--remote-debugging-port` so any local agent can connect over CDP. Chrome 136+ silently ignores that flag on the default profile directory, so the launcher points Chrome at a one-time APFS clone of the real profile — all logins, bookmarks, and extensions carry over at near-zero disk cost. Scripts live in this skill's `scripts/` dir; run them with absolute paths (`~/.claude/skills/chrome-cdp-setup/scripts/...`). ## Quick start ```bash scripts/setup_chrome_cdp.sh # full setup (default port 9222) scripts/verify_cdp.sh # endpoint + loopback + flags health check uv run --with playwright python scripts/cdp_agent_test.py # external-agent smoke test ``` ## Setup workflow 1. Preflight: confirm `/Applications/Google Chrome.app` exists and `/Applications` is writable; note profile size with `du -sh ~/Library/Application\ Support/Google/Chrome`. 2. Run `scripts/setup_chrome_cdp.sh [port]`. It is idempotent and: - quits Chrome cleanly (session restores on relaunch) - clones `~/Library/Application Support/Google/Chrome` → `Chrome-CDP` (`cp -Rc`; skipped if the clone already exists) - builds `/Applications/Google Chrome CDP.app` (Chrome's own icon, ad-hoc signed) - swaps the Dock's Chrome tile for the wrapper (Dock prefs backed up first) and restarts the Dock - launches the wrapper and waits for `http://127.0.0.1:<port>/json/version` 3.