Chrome-CDP-Skill: AI Access to Your Live Chrome Tabs
Chrome-CDP-Skill: Revolutionize AI Browser Automation
Imagine giving your AI agent eyes and hands on your actual Chrome browser—the tabs you have open right now, your logged-in Gmail/GitHub accounts, your current workflow state. No launching isolated browsers. No re-logging into services. No clean-slate page reloads.
🎯 Why Chrome-CDP-Skill Changes Everything
Traditional tools like Puppeteer or Playwright spin up fresh browser instances. chrome-cdp-skill connects directly to your live Chrome via the Chrome DevTools Protocol (CDP). Your AI sees:
- Pages you're already logged into (Gmail, GitHub, internal tools)
- Active tabs you're working in
- Real page state mid-workflow
2.6K GitHub stars prove developers love this approach.
🚀 Zero-Setup Installation
# As pi skill (easiest)
pi install git:github.com/pasky/[email protected]
# Or copy skills/chrome-cdp/ to your agent directory
# Only needs Node.js 22+ (no npm install)
Enable once: chrome://inspect/#remote-debugging → toggle switch.
⚡ Power-Packed CLI Commands
cdp list # List all open tabs
cdp shot tab1 # Screenshot current tab
cdp snap tab1 # Accessibility tree
cdp html tab1 ".main" # HTML of CSS selector
cdp click tab1 ".button" # Click by selector
cdp type tab1 "Hello AI" # Type in focused element
cdp eval tab1 "window.title" # Run JS in page context
cdp loadall tab1 ".more" # Auto-click 'Load More'
🛡️ Better Than chrome-devtools-mcp
| Feature | chrome-cdp-skill | chrome-devtools-mcp |
|---|---|---|
| Persistent connections | ✅ Per-tab daemons | ❌ Reconnects every command |
| "Allow debugging" modal | ✅ Once per tab | ❌ Pops repeatedly |
| 100+ tabs | ✅ Reliable | ❌ Target timeouts |
| Dependencies | ✅ Node.js only | ❌ Heavier stack |
🎛️ How the Magic Works
- Direct WebSocket to Chrome's remote debugging port
- Lightweight daemon spawns per tab (auto-exits after 20min idle)
- One-time "Allow debugging" per tab
- Reuse connections silently for all commands
🌐 Cross-Platform Auto-Detection
✅ macOS: Chrome, Chromium, Brave, Edge, Vivaldi
✅ Linux: + Flatpak browsers
✅ Windows/WSL: Uses LOCALAPPDATA, CDP_HOST
🚀 Get Started in 60 Seconds
- Clone:
git clone https://github.com/pasky/chrome-cdp-skill - Enable:
chrome://inspect/#remote-debugging - Run:
./scripts/cdp.mjs list
Your AI agent now controls your real browser. Perfect for Amp, Claude Code, Cursor, or any Node.js agent.