Autoresearch enables AI research engineers to run measured experiment loops within Claude Code or Codex. It automates the cycle of applying a scoped change, measuring it against a benchmark, and recording the outcome to iteratively optimize performance.
The system operates within defined budgets and user authorizations, allowing researchers to pause, resume, or inspect the progress of an optimization loop while maintaining manual control over scope changes.
Follow the documented setup, then try a first task.
Installs: Installs the autoresearch skill into ~/.agents/skills/autoresearch using a symlink; keep the repository checkout in place. · Codex
Platform: Linux and macOS; WSL on Windows
Run from: The parent directory for the checkout initially, then the autoresearch-claude-code repository root.
Clone the repository from the directory where its checkout should be created.
gh repo clone drivelineresearch/autoresearch-claude-code
Enter the repository checkout.
cd autoresearch-claude-code
From the repository root, run the Codex installer. The trailing text is the author's shell comment describing the destination.
./install.sh --codex # Codex skill in ~/.agents/skills/autoresearch
Installs: Installs the autoresearch skill, command, and four Claude Code hooks using symlinks; keep the repository checkout in place. · Claude Code
Platform: Linux and macOS; WSL on Windows
Run from: The parent directory for the checkout initially, then the autoresearch-claude-code repository root.
Clone the repository from the directory where its checkout should be created.
gh repo clone drivelineresearch/autoresearch-claude-code
Enter the repository checkout.
cd autoresearch-claude-code
From the repository root, run the Claude Code installer. The trailing text is the author's shell comment describing the installed bundle.
./install.sh --claude # Claude skill, command, and four hooks
Installs: Loads the autoresearch Claude Code plugin for the current session, including its shared skill and registered Claude hooks. Use this instead of the manual Claude installation to avoid duplicate hooks. · Claude Code
Platform: Linux and macOS; WSL on Windows
In a terminal, start Claude Code with the session-local plugin. Replace `/absolute/path/to/autoresearch-claude-code` with the absolute path to the existing repository checkout while preserving the rest of the command.
claude --plugin-dir /absolute/path/to/autoresearch-claude-code
Uses autoresearch
$autoresearch optimize test suite runtime with at most 20 runs
Claude
Codex