Autoresearch Wrapper— plugin

<div align="center">

Autoresearch Wrapper Banner

Dependency-aware optimization engine for any codebase.

Scan, plan, isolate, measure, repeat — all in Git worktrees, hands-free.

Inspired by Karpathy's autoresearch — constraint + mechanical metric + autonomous iteration = compounding gains.

<br>

"Just type /autoresearch-wrapper → everything's managed"

<br>

Install · Usage · Commands · Docs · 简体中文

</div>

Recently, I've been asking Codex to write autoresearch wrappers for the modules that I want to optimize. There's a concrete use case where I want to add a feature or module, and I have several candidates. But each time you add one, you need to optimize all the other related parts to get a sense of how helpful the module is (autoresearch-wrapper-create). That's when I wanted to implement a SKILL for this, and I thought that at the very beginning, before optimizing a system, we should understand the dependencies. So here it comes: a Dependency-aware Autoresearch Engine that wraps your modules, scripts, and more.

News

• 2026/10/15: v0.1.1.
• A comprehensive root SKILL.md documents every command, so the repo root can be installed as one skill.
• Advice-only code moved into the skill instructions: the resources and reference commands and the .autoresearch-wrapper/plans/ files are gone (the CLI tells you what to do instead).
• The monitor skill now takes progress snapshots instead of running a blocking poll loop.
• 2026/10/15: v0.1.0.
• create / delete are now fair comparisons: every approach (or the deletion) and a no-change control arm are tuned with the same budget, then ranked by their tuned ceiling with compare.
• Tuning in those arms is limited to an enforced file scope.
• Runs now build on kept candidates, stop rules are enforced, and the new finalize merges the winner back and cleans up worktrees.
• Metric timeouts, safe parallel bookkeeping, and many smaller fixes.
• One skill set now serves both Claude Code and Codex. For Codex, ln -s /path/to/autoresearch-wrapper/skills/* ~/.agents/skills/ gives you every command as its own skill; the old repo-root install still works as one comprehensive skill.
• Breaking: create/delete runs made with older versions can't be compared; recreate them.
• 2026/03/25: Refreshed the Claude marketplace package so the wizard-first flow and bundled scripts install correctly from the plugin cache.
• 2026/03/23 2:31 AM, Beijing Time: I've decided to release it at v0.0.2! Just feel excited to share it with the community. Although I'm still going through all the features to make sure they are everything I want, I think it is ready to play with.

Install

<details open> <summary><b>Claude Code (recommended)</b></summary>

/plugin marketplace add HenryCai11/autoresearch-wrapper
/plugin install autoresearch-wrapper

To update to the latest version:

/plugin marketplace update autoresearch-wrapper
/plugin update autoresearch-wrapper

If you installed an older 0.0.2 marketplace build before the plugin packaging changes, run:

/plugin marketplace update autoresearch-wrapper
/plugin remove autoresearch-wrapper
/plugin install autoresearch-wrapper

To uninstall:

/plugin remove autoresearch-wrapper

Or install manually:

git clone https://github.com/HenryCai11/autoresearch-wrapper.git

Claude Code discovers skills from .claude/skills/ automatically. To use them in all your projects, symlink the skill folders into your user skills directory:

mkdir -p ~/.claude/skills
ln -s /path/to/autoresearch-wrapper/skills/* ~/.claude/skills/

The marketplace package lives under plugins/autoresearch-wrapper/ and is generated from skills/.

</details>

<details> <summary><b>Codex</b></summary>

Codex reads the same skill folders. Inside this repo they are picked up from .agents/skills/. To use them everywhere:

mkdir -p ~/.agents/skills
ln -s /path/to/autoresearch-wrapper/skills/* ~/.agents/skills/

Invoke skills with $autoresearch-wrapper, $autoresearch-wrapper-run, and so on (or pick from /skills). Restart Codex after installing.

Alternatively, install the repo root as one comprehensive skill (ln -s /path/to/autoresearch-wrapper ~/.agents/skills/autoresearch-wrapper); the root SKILL.md covers every command. The older ~/.codex/skills/autoresearch-wrapper install keeps working the same way. Pick one style: both provide a skill named autoresearch-wrapper.

</details>

<details> <summary><b>CLI only</b></summary>

No installation needed — run directly:

python3 scripts/autoresearch_wrapper.py scan

</details>

Usage

Just run

/autoresearch-wrapper

This starts a wizard that begins with a compact core-functionality scan, then guides you step-by-step through target selection and run setup. If you want the full repo-wide listing, use python3 scripts/autoresearch_wrapper.py wizard --full-summary.

Examples

An example of the wizard for optimizing Recursive Language Models

example_rlm

Commands

One skill set serves both tools: invoke a skill as /<skill> in Claude Code or $<skill> in Codex.

Additional CLI subcommands: scan, configure, allocate, evaluate, record, arm-ready, compare, finalize, preset-metric

When a run ends, finalize --run-id <id> --merge squash-merges the best candidate into your checkout (staged for review, not committed) and removes the run's worktrees.

Testing

python3 -m unittest -q

Documentation

Acknowledgment

I'm inspired by several autoresearch projects. They are Karpathy's autoresearch, and uditgoenka's autoresearch. Thanks!