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.