Autoresearch
v2.1.0 — Issues
Autonomous overnight iteration engine for Claude Code. Fire it before bed, review improvements in the morning.
Inspired by Karpathy's autoresearch. Applies constraint-driven autonomous iteration to any git-backed codebase with a deterministic verification command.
Core loop: Modify → Verify → Keep/Discard → Repeat.
What It Does
You give autoresearch a goal, a scope (which files to touch), and a verification command that outputs a number. It then autonomously:
- Creates an isolated
autoresearch/<timestamp>branch - Makes one small, atomic change
- Commits it
- Runs your verification command
- Keeps the change if the metric improved (strict improvement only — equal values are discarded), resets if it didn't
- Repeats until iterations run out, time expires, or it gets stuck
Every kept change is a git commit on the isolated branch. Every discarded change is cleanly reset (no revert commits). In the morning you get a structured report (file + terminal summary) showing what happened.
Commands
| Command | Purpose |
|---|---|
/autoresearch | Core autonomous loop — runs unattended |
/autoresearch:plan | Interactive setup wizard — builds your config |
/autoresearch:debug | Scientific-method bug hunting |
/autoresearch:fix | Iterative error repair until zero remain |
/autoresearch:security | Autonomous security audit — STRIDE + OWASP Top 10 + red-team personas |
/autoresearch:learn | Autonomous codebase documentation engine |
/autoresearch:predict | Multi-persona swarm analysis from expert views |
/autoresearch:scenario | Scenario-driven use case & edge case generator |
/autoresearch:ship | Structured shipping workflow (PR, release notes, deploy checklist) |
Quick Start
Prerequisites
- Claude Code with marketplace plugin support
- A git-backed codebase with a clean working tree (no uncommitted changes)
- A deterministic verification command that outputs a number
Install
# Add the marketplace source
/plugin marketplace add Maleick/claude-autoresearch
# Install the plugin
/plugin install autoresearch@Maleick-claude-autoresearch
# Reload to activate
/reload-plugins
Update
The marketplace caches the plugin at install time — it won't automatically detect new versions on the remote. To check for and install updates:
/plugin marketplace update Maleick/claude-autoresearch
You'll be prompted to enable auto-update. With auto-update on, the marketplace checks for new versions periodically. Without it, run the update command manually when you want the latest version.
You can verify your installed version in Customize > Autoresearch — the version number is shown at the top of the plugin panel.
Use
# Use the wizard to set up your first run
/autoresearch:plan
# Or configure directly
/autoresearch Goal: "Reduce bundle size" Scope: "src/**/*.ts" Metric: "bundle size KB" Verify: "npm run build 2>&1 | grep 'bundle size' | awk '{print $3}'" Direction: minimize Iterations: 50