diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..07a7c3c
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,3 @@
+__pycache__/
+*.pyc
+.worktrees/
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..0883cab
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,23 @@
+# 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": ["..."] }`
diff --git a/bin/.gitkeep b/bin/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/tests/.gitkeep b/tests/.gitkeep
new file mode 100644
index 0000000..e69de29