bdg

Automate browser control via Chrome DevTools Protocol from the command line.

148|9|Updated Oct 31, 2025
One-click install
npx skills add https://github.com/szymdzum/browser-debugger-cli --skill bdg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bdg
Source: https://github.com/szymdzum/browser-debugger-cli/tree/main/.claude/skills/bdg
Command: npx skills add https://github.com/szymdzum/browser-debugger-cli --skill bdg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

bdg provides a lightweight command-line tool to automate browser tasks via the Chrome DevTools Protocol, enabling programmatic control of a browser session from anywhere.

Core Features & Use Cases

  • Direct CDP access to over 60 domains and 300+ methods for DOM, navigation, screenshots, network, and JavaScript execution.
  • Session management with persistent sessions, status checks, and safe cleanup to support long-running AI agent tasks.
  • Composable and portable: integrates with pipes, jq, and shell scripts for automation and data extraction.

Quick Start

Start a session by pointing to a URL, capture a screenshot, and stop the session: bdg https://example.com bdg dom screenshot /tmp/page.png bdg stop

Frequently Asked Questions about bdg

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate browser control via Chrome DevTools Protocol from the command line?

You can automate browser control via the Chrome DevTools Protocol from the command line by launching a headless or headed Chrome session. This tool provides direct CDP access to over 60 domains for DOM queries, navigation, and JavaScript execution.

Can I manage persistent browser sessions for long-running AI agent tasks?

Yes, you can manage persistent browser sessions for AI agent tasks. The tool provides session management with status checks and safe cleanup, allowing you to maintain state across multiple command-line operations.

Do I need Node.js to run headless Chrome automation with CDP?

Yes, you need Node.js and npm installed to run this headless Chrome automation tool. It requires a Node.js environment to launch Chrome instances and execute CDP commands for browser control.

What is the best way to capture screenshots and extract DOM data using CDP?

The best way to capture screenshots and extract DOM data using CDP is through this command-line tool. It outputs token-efficient results and integrates with pipes and jq, enabling seamless data extraction and shell script automation.

How do I execute JavaScript and control network requests in a headless browser?

To execute JavaScript and control network requests in a headless browser, you can use this CLI tool's direct CDP access. It targets over 60 CDP domains, allowing programmatic execution of scripts and network interception.