Manage persisted state¶

Goal: Decide what reyn state to commit, what to gitignore, and where to put it.

What lives under `.reyn/`¶

.reyn/ is an opaque runtime-state directory — treat it as tool-managed, not human-edited.

Path	Purpose	Default git status
`.reyn/approvals.yaml`	Saved permission approvals	gitignore
`.reyn/events/`	Per-run event JSONL logs	gitignore
`.reyn/agents/`	Per-agent profiles, chat history, state	gitignore
`.reyn/eval-results/`	Eval results per skill	gitignore
`.reyn/memory/`	Project-scoped memory	depends on the team
`.reyn/state/`	WAL + budget ledger (crash recovery)	gitignore

reyn.yaml (the project config) is checked in. Personal overrides go in reyn.local.yaml (gitignored, project root) — not in .reyn/config.yaml.

Note: .reyn/config.yaml is deprecated (ADR-0031). If it exists, Reyn warns and ignores it. Move its contents to reyn.local.yaml.

.reyn/
reyn.local.yaml

Memory is a judgment call:

Commit .reyn/memory/ when the project memory is shared knowledge (conventions, decisions) and collaborators benefit from it.
Gitignore it when memory is per-developer notes you don't want to push.

The default location is <project_root>/.reyn/. Override per-project:

# reyn.yaml
state_dir: /var/lib/reyn/<project>

Or per-run via --state-dir (when supported by the subcommand) — generally the project setting is enough.

~/.reyn/ mirrors the per-project shape:

~/.reyn/config.yaml — user-global defaults (your default model, API base, etc.). This file is still active (not deprecated).
~/.reyn/memory/ — global memory (facts about you across all projects).

recall_memory reads both global and project scopes.

Path	Safe to delete?	Notes
`.reyn/events/`	Yes	Just logs. You lose replay data.
`.reyn/eval-results/`	Yes	Regenerable.
`.reyn/agents/`	Yes	You lose agent profiles, chat history, and skill-resume checkpoints.
`.reyn/approvals.yaml`	Yes	You'll be re-prompted on the next run.
`.reyn/memory/`	Maybe	You lose persisted facts. Export first: `reyn memory export --out memory.json`.

reyn.yaml and reyn.local.yaml are config; deleting them resets to defaults.