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:

1. Creates an isolated autoresearch/<timestamp> branch
2. Makes one small, atomic change
3. Commits it
4. Runs your verification command
5. Keeps the change if the metric improved (strict improvement only — equal values are discarded), resets if it didn't
6. 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

Running Overnight

Option 1: Manual (Simple)