Autoresearch

Domain-agnostic autonomous experiment runner. Optimizes a single metric by iterating: hypothesis -> code change -> verify -> keep/discard.

What You Get

• JSONL experiment log with metric history, deltas from baseline, and commit SHAs
• Markdown results dashboard comparing all iterations
• Git branch per experiment with keep/discard via commit/revert

CLI Usage

# Initialize an experiment
autoresearch init noir-gates \
  --objective "minimize constraint count" \
  --metric constraints \
  --verify "nargo compile 2>&1 | grep constraints" \
  --direction lower \
  --mutable src/main.nr

# Run a single iteration
autoresearch run "inline witness computation"

# Autonomous loop (Claude generates hypotheses)
autoresearch loop --iterations 10 --model claude-sonnet-4-6

# View results
autoresearch dashboard
autoresearch status

MCP Server

autoresearch serve

Configure MCP

Add to ~/.mcp.json:

{
  "mcpServers": {
    "autoresearch": {
      "command": "autoresearch",
      "args": ["serve"]
    }
  }
}

MCP Tools

Install

cd agents/autoresearch
pip install -e .

Requires ANTHROPIC_API_KEY for the autonomous loop (hypothesis generation).