browser-debugger-cli (bdg)
browser-debugger-cli
CLI bdg держит Chrome открытым в фоне и отдает агенту сеть, консоль, куки и стили короткими командами, без скриншотов и MCP.
- 185 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Команды читают куки, включая HttpOnly, и заголовки Authorization, а `bdg eval` выполняет JavaScript на открытой странице. В сессии с рабочим входом агент видит токены.
- Подключение к обычному Chrome открывает вкладки профиля. Начинайте с отдельной сессии на localhost.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/browser-debugger-cliОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Команды читают куки, включая HttpOnly, и заголовки Authorization, а `bdg eval` выполняет JavaScript на открытой странице. В сессии с рабочим входом агент видит токены.
- Подключение к обычному Chrome открывает вкладки профиля. Начинайте с отдельной сессии на localhost.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
bdg запускает Chrome в фоне и принимает команды по одной: открыть страницу, кликнуть, заполнить поле, затем прочитать запросы сети, ошибки консоли, куки, стили и раскладку элемента. Вывод компактный и годится для `jq`, поэтому агент тратит мало токенов. Агент работает без заранее написанного сценария: делает шаг, читает ответ браузера и выбирает следующий. Для остального есть `bdg cdp` с любыми методами протокола Chrome DevTools. Команда `bdg install-skill` ставит скилл с описанием рабочего цикла для Claude Code, Codex и Gemini CLI.
Для кого. Веб-разработчикам, которые просят Claude Code или Codex разобраться, почему страница на localhost не работает, и хотят видеть ответы сети и консоли.
Подходит, если
- Кнопка корзины молчит, а агенту надо увидеть ответ 500 и ошибку в консоли.
- Нужно проверить форму: заполнить поля, нажать отправку и прочитать подтверждение.
- Страница ломается на узком экране, и агент меряет раскладку элемента при эмуляции мобильного вьюпорта.
- Контраст текста проверяют по всей странице и получают список от самых слабых мест.
- Сессия входа уже открыта в браузере, и ее куки нужно передать в `curl` для проверки API.
Не подходит, если
- Для длинных тестовых наборов с отчетами и CI лучше Playwright или Puppeteer.
- Рабочий процесс построен вокруг MCP-серверов или нужны аудиты Lighthouse из коробки: README советует Chrome DevTools MCP.
- Страницу открывают в Firefox или Safari, потому что bdg говорит только на протоколе Chrome DevTools.
Пример запроса к агенту
Открой localhost:3000 через bdg, нажми кнопку «В корзину» и покажи, какой запрос ушел и что написала консоль.Ограничения
Нужны Node.js 22.12 или новее и браузер на Chromium: Chrome, Chromium или Edge. Работает на macOS, Linux и Windows через WSL, а нативный PowerShell и Git Bash пока не поддерживаются. Firefox и Safari не подходят. Подключение к вашему обычному Chrome требует включить удаленную отладку на `chrome://inspect/#remote-debugging`, и Chrome спрашивает разрешение на каждое подключение. Для локальных серверов с самоподписанным сертификатом добавляют флаг `--chrome-flags="--ignore-certificate-errors"`. Сравнение с Chrome DevTools MCP в README основано на одном прогоне ноября 2025 года, оба инструмента с тех пор изменились.
Как отключить. Остановите сессию командой `bdg stop` и удалите пакет через `npm uninstall -g browser-debugger-cli`. Скилл лежит в `~/.claude/skills` и `~/.agents/skills`, его папку `bdg` удалите вручную.
Частые вопросы
Как поставить bdg для Claude Code?
Выполните `npm install -g browser-debugger-cli`, затем `bdg install-skill` (флаг `--claude` ставит только для Claude Code). После этого начните новую сессию агента: скилл загрузится, когда задаче нужен браузер, или по команде `/bdg`.
Нужен ли для bdg MCP-сервер?
Нет. Каждая команда bdg — обычный процесс оболочки, агент вызывает ее через shell. Справку по всем командам он получает сам: `bdg --help --json`.
Как увидеть запросы и ошибки консоли?
Команда `bdg network list --preset errors` показывает неудачные запросы, а `bdg console` выводит сообщения консоли. Все данные доступны на ходу, пока сессия открыта.
Можно ли подключить bdg к уже открытому Chrome?
Да. Включите удаленную отладку на `chrome://inspect/#remote-debugging` и выполните `bdg attach`. Команда покажет вкладки и подключится к выбранной без перезагрузки.
Чем bdg отличается от Chrome DevTools MCP?
bdg отдает данные браузера командами оболочки без MCP-сервера. Chrome DevTools MCP README советует взять, если рабочий процесс построен вокруг MCP или нужны аудиты Lighthouse, трассы производительности и анализ кучи.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыСкилл для Amp, Claude Code и Cursor: агент управляет вашим живым Chrome с открытыми вкладками и входами в аккаунты через один переключатель отладки
CLI, скилл и MCP для управления Chrome короткими скриптами Puppeteer, вкладки сохраняют состояние между вызовами
CLI и скилл для управления Chrome из агента: снимок страницы, клики, консоль, сеть и аудит производительности в экономном выводе
Бинарник на Rust без MCP-сервера: агент ведет ваш открытый Chrome или Edge, а вкладки закрепляются метками target.
Агент работает в вашем настоящем Chrome с уже выполненными входами: CLI, MCP и расширение с отдельной группой вкладок
Нативный CLI на Rust для Chrome через CDP: более 90 команд, MCP-сервер на 50 инструментов и постоянный демон со снимками.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| browser-debugger-cli (bdg) (эта карточка) | нет | 185 | ||
| Chrome DevTools MCP | да | не нужна | 55 199 | MCP-сервер DevTools с аудитами Lighthouse и анализом кучи; bdg дает те же данные обычными командами оболочки |
| agent-browser-cli | нет | 649 | общий CLI для управления браузером агентом; bdg сфокусирован на отладке: сеть, консоль, CSS-каскад, сырой CDP |
Коротко о README
Автор подает bdg как пару к ассистенту для отладки живой страницы шаг за шагом. В README приведены примеры отладки и автоматизации, таблица областей (страница, ввод, инспекция, телеметрия, профилирование, сессии) и отдельный раздел о том, когда лучше взять Playwright или Chrome DevTools MCP.