pi-autoresearch for Claude Code

Uses the new mods api to change claude code's UI for the same autoresearch experience as in pi.

A Claude Code mod that runs autonomous optimization loops. It will try an idea, benchmark it, keep improvements, revert regressions and repeat this process in a structured way.

For more information see, pi-autoresearch, this is an almost 1:1 port of that (removing some small bugs).

Inspired by karpathy/autoresearch.

The session format is the same as pi-autoresearch (.auto/log.jsonl) and can be used interchangedly.

Quick start

claude plugin marketplace add bn-l/claude-autoresearch-mod
claude plugin install autoresearch@bn-l

To try it on a toy project first, copy examples/sort-bench somewhere, make it a git repository, and run /autoresearch make sort.js faster in it.

Requirements

Requires Claude Code 2.1.285 or newer with CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1 set in ~/.claude/settings.json (see the Claude Code docs for more info).

The browser dashboard (very optional) requires node (18 or newer) or bun.