CDP Mode

# 1. Start Chrome with remote debugging
google-chrome --remote-debugging-port=9222

# 2. Connect once, then run commands
agent-browser connect 9222
agent-browser snapshot
agent-browser click @e1
agent-browser close

# Or pass --cdp on each command
agent-browser --cdp 9222 snapshot
agent-browser --cdp 9222 click @e1

# Auto-discover running Chrome
agent-browser --auto-connect snapshot
agent-browser --auto-connect click @e1

# Or via environment variable
export AGENT_BROWSER_AUTO_CONNECT=1
agent-browser snapshot

# Connects to http://localhost:9222
agent-browser --cdp 9222 snapshot

if (/^\d+$/.test(cdpEndpoint)) {
  // Port number - connect to localhost
  cdpUrl = `http://localhost:${cdpEndpoint}`;
}

# Connect to remote browser via WebSocket
agent-browser --cdp "wss://your-browser-service.com/cdp?token=..." snapshot

# Connect to local Chrome via WebSocket
agent-browser --cdp "ws://localhost:9222/devtools/browser/..." snapshot

if (
  cdpEndpoint.startsWith('ws://') ||
  cdpEndpoint.startsWith('wss://') ||
  cdpEndpoint.startsWith('http://') ||
  cdpEndpoint.startsWith('https://')
) {
  cdpUrl = cdpEndpoint;
}

/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome \
  --remote-debugging-port=9222

google-chrome --remote-debugging-port=9222
# or
chromium --remote-debugging-port=9222

"C:\Program Files\Google\Chrome\Application\chrome.exe" --remote-debugging-port=9222

chrome --headless --remote-debugging-port=9222

# First command establishes connection
agent-browser --cdp 9222 open example.com

# Subsequent commands reuse the connection
agent-browser --cdp 9222 snapshot
agent-browser --cdp 9222 click @e1

# Close disconnects and shuts down daemon
agent-browser --cdp 9222 close

this.cdpEndpoint = cdpEndpoint;

private needsCdpReconnect(cdpEndpoint: string): boolean {
  // Reconnect if endpoint changed
  if (this.cdpEndpoint !== cdpEndpoint) return true;
  // ... connection health checks ...
}

private readDevToolsActivePort(userDataDir: string): { port: number; wsPath: string } | null {
  const filePath = path.join(userDataDir, 'DevToolsActivePort');
  // ...
}

# Check if any debuggable instance is running on default ports
curl http://localhost:9222/json/version

# This will fail
agent-browser --profile ./profile --cdp 9222 open example.com
# Error: Profile cannot be used with CDP connection

if (hasProfile && cdpEndpoint) {
  throw new Error('Profile cannot be used with CDP connection');
}

# This will fail
agent-browser --extension ./my-ext --cdp 9222 open example.com
# Error: Extensions cannot be used with CDP connection

agent-browser --download-path ./downloads --cdp 9222 open example.com
# Warning: --download-path is ignored when connecting via CDP

private async invalidateCDPSession(): Promise<void> {
  // Stop screencast if active (it's tied to the current page's CDP session)
  if (this.screencastActive) {
    await this.stopScreencast();
  }

  // Detach and clear the CDP session
  if (this.cdpSession) {
    try {
      await this.cdpSession.detach();
    } catch {
      // Session may already be detached
    }
    this.cdpSession = null;
  }
}

# Enable streaming on port 9223
export AGENT_BROWSER_STREAM_PORT=9223
agent-browser --cdp 9222 open example.com

# Connect to ws://localhost:9223 to receive frames

await browser.injectMouseEvent({
  type: 'mousePressed',
  x: 100,
  y: 200,
  button: 'left',
});

agent-browser --cdp 9222 profiler start
agent-browser --cdp 9222 open example.com
agent-browser --cdp 9222 profiler stop ./profile.json

# Start Electron app with debugging
electron . --remote-debugging-port=9222

# Connect and automate
agent-browser --cdp 9222 snapshot
agent-browser --cdp 9222 click @e1

# Start Chrome with extension and remote debugging
chrome --load-extension=./my-extension --remote-debugging-port=9222

# Automate testing
agent-browser --cdp 9222 open chrome://extensions
agent-browser --cdp 9222 snapshot

# WebView2 apps typically expose CDP on a dynamic port
# Use auto-connect or discover the port manually
agent-browser --auto-connect snapshot

# Browserbase (uses CDP internally)
agent-browser -p browserbase open example.com

# Browser Use (uses CDP internally)
agent-browser -p browseruse open example.com

# Kernel (uses CDP internally)
agent-browser -p kernel open example.com

# Safe - localhost only
chrome --remote-debugging-port=9222

# Dangerous - exposed to network!
chrome --remote-debugging-port=9222 --remote-debugging-address=0.0.0.0

# Dedicated instance for automation
chrome --user-data-dir=/tmp/automation-profile --remote-debugging-port=9222

Failed to connect via CDP to http://localhost:9222

agent-browser close  # Clean up stale connection
agent-browser --cdp 9222 open example.com  # Reconnect