codex-bug-reproducer
v0.2.0
Published
A consent-first Codex skill that finds likely bugs, proves them with tests, and verifies approved fixes.
Maintainers
Readme
Codex Bug Reproducer
A consent-first Codex skill that scans a codebase for likely bugs, ranks concrete candidates, and proves or rejects them with focused tests. It can also turn bug reports, stack traces, screenshots, and failing behavior into minimal reproducible cases, then prove approved fixes with red-to-green evidence.
You do not need to know the bug first. Bug Reproducer inspects contracts, boundaries, state transitions, error paths, and real callers to identify specific triggering cases. It never claims a bug from code inspection alone: a candidate becomes a proven bug only when an approved focused test fails for the predicted reason.
What it does
- Finds likely correctness bugs without requiring a bug report
- Ranks candidates by contract evidence, reachability, reproducibility, and impact
- Shows the exact trigger, expected result, likely actual result, and source location
- Requires approval before creating reproduction files
- Builds focused deterministic tests for the strongest approved candidates
- Rejects setup errors and unrelated failures as false reproductions
- Isolates the root cause
- Requires separate approval before changing production code
- Captures the same targeted command before and after
- Returns
FIX_PROVEN,STILL_FAILING,NOT_REPRODUCED, or another honest evidence status - Creates a native Markdown report that opens directly in Codex
Installation
npx --yes codex-bug-reproducer@latestThis installs the skill into:
~/.codex/skills/bug-reproducerRestart Codex after installation.
Usage
Open any project and call it directly:
Use $bug-reproducer to scan this codebase for likely bugs, rank the strongest candidates, and ask before creating tests or changing code.You can also provide a known bug:
Use $bug-reproducer to investigate this bug: requesting page 1 skips the first results. Propose a minimal reproduction and wait for my approval before changing project files.For discovery and tests without a production fix:
Use $bug-reproducer in reproduce-only mode to find and prove likely bugs in this project. Do not change production code.Two approval gates
The first approval covers only the displayed candidate tests or reproduction harness. After a bug is proven, the skill explains the root cause and requests a separate approval for the exact production patch.
If the required files or approach change, it must stop and ask again. It cannot use a broad initial instruction as permission to modify the project.
Evidence labels
REPRODUCEDNOT_REPRODUCEDNO_BUG_PROVENINCONCLUSIVESTILL_FAILINGFIX_UNVERIFIEDFIX_REGRESSIONFIX_PROVEN
Output
outputs/bug-reproducer-evidence.json
outputs/bug-reproducer-report.mdThe report includes the original bug, expected versus actual behavior, minimal reproduction, root cause, approved files, red/green evidence, broader checks, limitations, and residual risks.
Manual installation
git clone https://github.com/Kappaemme-git/codex-bug-reproducer.git
mkdir -p ~/.codex/skills
cp -R codex-bug-reproducer/bug-reproducer ~/.codex/skills/bug-reproducerRestart Codex after installation.
License
MIT
