szymdzum/browser-debugger-cli

szymdzum

TypeScript151updated 1mo ago

Let Claude Code and other coding agents drive and debug Chrome from the shell. DOM, network, console and raw CDP as short commands, no screenshots and no MCP needed.

ClaudeCodexCursorMCP

agent-skillsagentic-codingai-agentsai-toolsbrowser-automationcdpchromechrome-devtools-protocolclaude-codeclicodexcoding-agents

View on GitHub

README

bdg - Browser Debugger CLI

Give your AI agent a real browser. And the DevTools to go with it.

📖 Wiki: Getting Started · Commands · For AI Agents · Recipes · Quick Reference · Troubleshooting · CLI reference

bdg keeps a browser session open in the background and lets you drive it one shell command at a time. Click, fill, navigate, then read what actually happened: requests, console errors, layout and styles. It is built for coding agents like Claude Code, Codex and Gemini CLI, and it's just as handy in your own terminal. Every command is a plain process with compact output, so it pipes into jq and costs an agent few tokens.

npm install -g browser-debugger-cli
bdg localhost:3000

Two ways to use it

Debug a page: browser telemetry on demand

![The cart button does nothing; bdg shows the 500 response, the console error and the missi