# autoresearch

Autonomous research loop for Claude Code. Runs inside tmux, one window per project.

## Key files
- `bin/start.sh` — tmux session orchestrator (start/stop/status)
- `bin/check_budget.py` — Anthropic API budget checker
- `bin/log_view.py` — formatted log viewer (overview pane, left)
- `bin/metrics.py` — metrics summary (overview pane, right)
- `~/.claude/autoresearch.yaml` — main config
- `~/.claude/skills/autoresearch/skill.md` — /autoresearch skill
- `~/.claude/skills/autoresearch-loop/skill.md` — /autoresearch-loop (ralph-loop payload)

## Run
```
bin/start.sh          # start tmux session
bin/start.sh stop     # stop all windows
bin/start.sh status   # show running experiments
```

## Logs
- `~/.claude/autoresearch/log.jsonl` — append-only experiment log
- Each line: `{ "ts": "ISO8601", "project": "...", "exp": "NNNN", "metric_before": 0.0, "metric_after": 0.0, "kept": true, "files_changed": ["..."] }`