CodexPotter
by breezewish
Autonomous reconciliation loop that drives Codex to align your codebase with instructed states.
What it does
CodexPotter implements the "Ralph loop" pattern, continuously reviewing and reconciling a codebase toward a target state defined in instructions (like MAIN.md), ensuring higher quality and consistency than single-pass edits.
Tools
- codebase-reconciler: Continuously applies changes to match the desired state
- task-executor: Drives the local Codex CLI to perform targeted project tasks
- context-manager: Ensures clean-room context in each iteration to avoid context poisoning
Installation
npm install -g codex-potter
# then run
codex-potter --yolo
Supported hosts
- Codex
Quick install
npm install -g codex-potterInformation
- Pricing
- free
- Published
- 4/14/2026
- Updated
- yesterday
- stars







