- CollectionBrowser & Web Execution
- Classificationagent-native
- LicenseMIT
- MCPUnavailable
- Agent SkillAvailable
- InterfacesAgent Skill · websocket · CLI
What it does
bdg keeps a browser session open in the background and lets an agent drive it one shell command at a time: click, fill, navigate, then read requests, console errors, layout, styles and the accessibility tree. Every DevTools capability is reachable through raw CDP (bdg cdp <Method>), with search and --describe introspection. Output is compact and pipes into jq, and semantic DOM output cuts tokens versus raw HTML.
Agent-facing interfaces
- Interaction pattern: Structured CLI + Agent Skill
- Catalog protocols: Agent Skill, websocket, CLI
- MCP: ❌ Not provided by design — the project describes itself as “no screenshots and no MCP needed”; agents call it as a shell CLI.
- Agent Skill: ✅ Ships an agent skill
- Onboarding type:
agent-skill
How agents onboard
Interaction pattern: Structured CLI + Agent Skill
npm install -g browser-debugger-cli
bdg localhost:3000 # start a background browser session
bdg --help --json # machine-readable command map for the agent
bdg cdp --search cookie # discover raw CDP methods
bdg install-skill # install the bdg skill for Claude Code, Codex, Gemini CLI, ...
See the full onboarding section in the dossier.
Protocol surface
| Interface | Detail |
|---|---|
| CLI | bdg <url>, bdg dom …, bdg cdp …, --json output, exit codes |
| CDP | Unix socket → worker → Chrome DevTools WebSocket |
| Skill | bdg install-skill |