What problem does it solve?
It removes the manual trial-and-error of improving a repository by running an end-to-end, benchmark-driven evolution loop that designs, implements, validates, and selects code changes.
Core Features & Use Cases
- Autonomous improvement lifecycle: Orchestrates research, hypothesis planning, architectural/critic review, execution on isolated worktrees, and tournament-based selection.
- Benchmark-first optimization: Uses a user-defined benchmark command and stop conditions to iteratively search for measurable gains.
- Safety and anti-self-modification guardrails: Enforces sealed-file constraints via validate.sh and uses a worktree strategy to isolate experiments and avoid unintended edits.
Real-world use cases:
- Improve performance or quality metrics in an existing codebase by iteratively testing candidate changes against a deterministic evaluation command.
- Drive systematic experimentation when you know a target metric but need the loop to generate and verify hypotheses under constraints.
Quick Start
Use the self-improve orchestrator by running the self-improvement session setup, then start the loop to iteratively improve your target repo until a stop condition is reached.