What problem does it solve?
Debug Mode enables hypothesis-driven debugging by running two autonomous AI tracks in parallel, each reviewing and refining its own fixes, then synthesizing their findings for high-confidence changes.
Core Features & Use Cases
- Dual-track debugging workflow that leverages Opus 4.5 and GPT 5.2 to explore complementary fixes.
- Context-building, reproduction strategy, and patch coordination across tracks.
- Use Case: When standard debugging fails or flaky CI tests occur, spin up parallel AI tracks to converge on a fix quickly.
Quick Start
Install prerequisites (bun, tmux, Codex CLI), initialize the debug-session with debug-mode init /path/to/project, run track iterations with debug-mode codex run track-a 1 /tmp/debug-track-a-prompt.md and debug-mode codex run track-b 1 /tmp/debug-track-b-prompt.md, monitor status with debug-mode status track-a and debug-mode status track-b, compare changes with debug-mode diff track-a / debug-mode diff track-b, and finally apply with debug-mode apply track-a /path/to/project.