# browser-debugger

Субагент browser-debugger воспроизводит ошибки в браузере, собирает UI- и сетевые свидетельства и помогает найти причину клиентского сбоя.

- субагент · `type=agent` · Codex, Claude Code, Cursor · ★ 6505 у репозитория
- Автор: VoltAgent
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/VoltAgent/awesome-codex-subagents/tree/HEAD/categories/04-quality-security/browser-debugger.toml
- Обновлён: 2026-10-05
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/browser-debugger

## Что делает

browser-debugger разбирает пользовательский сценарий через browser MCP server. Он фиксирует точные шаги воспроизведения, входные данные и расхождение между ожидаемым и фактическим поведением. В анализ входят запросы и ответы сети, коды, тайминги, кэш, ошибки консоли, DOM, события, состояние интерфейса и ограничения storage, session, cookie и CORS.

Субагент отделяет подтверждённые факты от гипотез, проверяет обычный путь, ошибочный сценарий и интеграционную границу, если это возможно. Затем он предлагает минимальное исправление, описывает проверенное и оставшийся риск, а результат оформляет так, чтобы его мог использовать родительский агент. Он не уходит в несвязанный рефакторинг фронтенда без отдельного запроса.

Для работы нужен browser MCP server: без него браузерное воспроизведение и сбор таких свидетельств не выполнятся. Для Codex файл субагента размещают по пути `.codex/agents/browser-debugger.toml`.

## Установка

### Codex (родная платформа)

**Вручную: положить файлы**
- Файл: `.codex/agents/browser-debugger.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Claude Code

**Вручную: положить файлы**
- Файл: `.claude/agents/browser-debugger.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/browser-debugger.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/VoltAgent/awesome-codex-subagents/tree/HEAD/categories/04-quality-security/browser-debugger.toml

## Когда брать
- воспроизвести сбой в пользовательском сценарии
- собрать запросы, ответы и ошибки консоли
- сопоставить дефект с DOM и состоянием интерфейса
- проверить различия между браузерами или viewport
- сформулировать минимальное исправление клиентского кода

## Примеры запросов агенту
- Воспроизведи сбой в форме авторизации через browser MCP server и запиши точные шаги, запросы и ошибки консоли.
- Проверь изменённый пользовательский путь: сравни ожидаемое и фактическое поведение, затем назови причину и минимальное исправление.
- Разбери проблему с CORS или cookie в браузере и укажи, что нужно перепроверить после изменения кода.

## Похожие
- [debugger](https://affpapa.org/nevibecode/agents/debugger.md) — субагент · 13459 установок
- [w-debug-browser](https://affpapa.org/nevibecode/skills/w-debug-browser.md) — скилл · 647 установок
- [browser-debugging](https://affpapa.org/nevibecode/skills/browser-debugging.md) — скилл · 547 установок
- [browser-tools](https://affpapa.org/nevibecode/skills/browser-tools.md) — скилл · 479 установок
- [k6-browser-test](https://affpapa.org/nevibecode/skills/k6-browser-test.md) — скилл · 678 установок
- [recording-browser-flow-as-test](https://affpapa.org/nevibecode/skills/recording-browser-flow-as-test.md) — скилл · 451 установка

Из того же набора: [voltagent/awesome-codex-subagents](https://affpapa.org/nevibecode/by/voltagent/awesome-codex-subagents.md) — 176 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
