# codex-debugger

Субагент codex-debugger передаёт расследование бага независимому Codex через локальный CLI и сам проверяет его диагноз по коду, прежде чем что-то предложить.

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

## Что делает

Субагент берёт на себя разбор падающего теста, краша или странного поведения фичи: сначала воспроизводит ошибку сам и фиксирует реальный вывод, затем отправляет в Codex (GPT-5) самостоятельный бриф с трассой, ожидаемым и фактическим поведением, подозрительными файлами и последними коммитами из `git log`. Codex ищет не симптом, а причину и называет конкретную строку кода.

Полученный диагноз субагент не принимает на слух: читает указанные строки сам, проверяет причинно-следственную цепочку и отклоняет красиво звучащий, но не подтверждённый код фрагмент. Если первый ответ Codex неубедителен, он продолжает тот же сеанс флагом `-r` с уточняющим вопросом — не больше двух раз, иначе отчёт идёт с тем, что удалось выяснить.

Патчи субагент только предлагает в виде диффа, не применяет — правка файлов в `-s workspace-write` ему запрещена. Каждый вызов тратит квоту плана ChatGPT пользователя.

## Установка

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

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add Sateezg/codex-bridge
```
В чате агента (не в терминале):
```text
/plugin install codex-bridge@codex-bridge
```

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

### Codex

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

### Cursor

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/Sateezg/codex-bridge/tree/HEAD/agents/codex-debugger.md

## Когда брать
- найти файл и строку, где реально рождается баг
- проверить, что предложенная Codex причина действительно объясняет симптом
- получить диагноз по падающему тесту без траты времени на ручной разбор
- собрать диф с минимальным патчем для ревью перед применением
- разобраться, почему баг проявляется только при флаге вроде `--parallel`

## Примеры запросов агенту
- Вызови codex-debugger, чтобы разобраться, почему падает тест test_parallel_write
- Передай стектрейс из последнего краша субагенту codex-debugger для анализа причины
- Попроси codex-debugger проверить, почему фикс из прошлого коммита не сработал

## Похожие
- [debugger](https://affpapa.org/nevibecode/agents/debugger.md) — субагент · 13459 установок
- [debugging-toolkit-debugger](https://affpapa.org/nevibecode/agents/debugging-toolkit-debugger.md) — субагент · ★ 42780 у репозитория
- [node-inspect-debugger](https://affpapa.org/nevibecode/skills/node-inspect-debugger.md) — скилл · 403 установки
- [llm-debugger](https://affpapa.org/nevibecode/skills/llm-debugger.md) — скилл · 259 установок
- [team-debugger](https://affpapa.org/nevibecode/agents/team-debugger.md) — субагент · ★ 42780 у репозитория
- [root-cause-debugger](https://affpapa.org/nevibecode/agents/root-cause-debugger.md) — субагент · ★ 4719 у репозитория

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

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

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