Chrome CDP

Lightweight Chrome DevTools Protocol CLI. Connects directly via WebSocket — no Puppeteer, works with 100+ tabs, instant connection.

Constraints

MUST explicitly ask for user permission before use. Chrome CDP runs in a headful browser in user screen. Start using Chrome CDP without user confirmation is offensive. User refuse: PAUSE IMMEDIATELY.

The headful browser will be the Chrome that user uses everyday with cookies and login states. Social media interactions requires user confirm.

Use agent-browser skill instead if you need stateless and headless access to web pages.

Prerequisites

• Chrome (or Chromium, Brave, Edge, Vivaldi) with remote debugging enabled: open chrome://inspect/#remote-debugging and toggle the switch
• Node.js 22+ (uses built-in WebSocket)
• If your browser's DevToolsActivePort is in a non-standard location, set CDP_PORT_FILE to its full path

Commands