Autoresearch
Check and run autonomous experiments. Query experiment status, view results dashboards, and execute iterations. TRIGGER when: user asks about experiment status, autoresearch progress, "how's the experiment going", "run another iteration", or invokes "/autoresearch". DO NOT TRIGGER when: user is working on autoresearch agent code itself.From its SKILL.md
npx -y skills add DROOdotFOO/agent-skills --skill autoresearchAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
3 things to look at
- reads credentialsReads from 1 credential source: `ANTHROPIC_API_KEY`.
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
- runs commandsInstructs the agent to run 7 commands, including `autoresearch init` and 6 more.
SKILL.md
2.0 KB, 373 tokens by cl100k_base, as published. Nobody here has run it
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
| Tool | Description |
|---|---|
autoresearch_status | Current experiment status (name, metric, runs, best) |
autoresearch_dashboard | Full results table as markdown |
autoresearch_run | Execute a single experiment iteration |
Install
cd agents/autoresearch
pip install -e .
Requires ANTHROPIC_API_KEY for the autonomous loop (hypothesis generation).
What ships with it
Read from the repository
Just SKILL.md. No reference files, no scripts.