Autoresearch
Agent skills, autonomous agents, and MCP-companions for programming
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.
One thing to look at
- 1 stars1 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.
What its author says it does
Copied from the file, not written here
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.
SKILL.md
2.0 KB, 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).