# Codex Autoresearch

Run repeated, measured Git experiments toward a numeric target; keep improvements and...

- Repository: https://github.com/leo-lilinxiao/codex-autoresearch (3088 stars)
- Category: Git and review
- License: MIT
- Last updated: 2026-09-12
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add leo-lilinxiao/codex-autoresearch --skill codex-autoresearch -g -a claude-code -y`
Codex: `npx skills add leo-lilinxiao/codex-autoresearch --skill codex-autoresearch -g -a codex -y`
Cursor: `npx skills add leo-lilinxiao/codex-autoresearch --skill codex-autoresearch -g -a cursor -y`
Gemini CLI: `npx skills add leo-lilinxiao/codex-autoresearch --skill codex-autoresearch -g -a gemini-cli -y`

## Description

Run repeated, measured Git experiments toward a numeric target; keep improvements and revert failures. Use for autonomous optimization or managing an autoresearch run, not one-shot edits.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Codex Autoresearch

Improve a repository through repeated, reversible experiments:

`hypothesize -> change -> measure -> learn -> keep or revert -> repeat`

Codex chooses hypotheses and makes code changes. The control script owns measurement, commits, rollback, and the event history.

## Respond To The Request

Resolve `<control>` to this skill's own `scripts/autoresearch.py`; do not assume it is installed in the target repository.

For a status or results request, run the corresponding command directly:

| Request | Command |
|---|---|
| Status | `python3 <control> status --repo <repo>` |
| History | `python3 <control> history --repo <repo>` |
| TSV export | `python3 <control> history --repo <repo> --format tsv` |
| HTML report | `python3 <control> report --repo <repo>` |

Report the requested result without starting or resuming experiments. Return the generated path for an HTML report.

Before starting or resuming an experiment, read the applicable workflow unless it is already in context:

- [Workflow](references/workflow.md): starting, continuing, resuming, or changing an experiment.
- [Background](references/background.md): launching or controlling a detached run.

## Experiment Boundary

The rest: https://github.com/leo-lilinxiao/codex-autoresearch/blob/HEAD//SKILL.md