Autoresearch

Autonomous experiment loop: try ideas, keep what works, discard what doesn't, never stop.

Tools

• init_experiment — configure session (name, metric, unit, direction). Call again to re-initialize with a new baseline when the optimization target changes.
• run_experiment — runs command, times it, captures output.
• log_experiment — records result. keep auto-commits. discard/crash/checks_failed auto-reverts code changes (autoresearch files preserved). Always include secondary metrics dict. Dashboard: ctrl+shift+t.

Session files

All session files live in a single .auto/ subfolder at the working directory root. This keeps everything in one place — easy to preserve across reverts, gitignore, and clean up.