What problem does it solve?
Autoresearch automates the repetitive, error-prone process of manually trying code changes, running measurements, and reverting regressions so you can systematically optimize a measurable metric in a codebase.
Core Features & Use Cases
- Interactive setup: Walks the user through defining a clear goal, an exact metric command and extraction rule, in-scope and out-of-scope files, constraints, and experiment budget.
- Autonomous experiment loop: Creates a branch, commits experiments, runs the metric command, extracts results, keeps improvements, and reverts regressions while logging each attempt to results.tsv.
- Safe guardrails: Respects out-of-scope files, requires user approval for environment changes, enforces baseline measurements, and limits experiments according to user constraints.
- Use cases: Performance tuning, reducing build or binary size, improving test pass rates, or any optimization where an exact command produces a numeric metric.
Quick Start
Tell the agent your optimization goal, provide the exact command and extraction rule to measure it, specify which files it may modify, list any constraints and the experiment budget, then confirm to begin.