memo

# AIOS Memory (memo) Working directory: project root. Memory commands run from the repo root. ## Principle: you decide, the harness executes The harness only *provides capabilities* and does **not** judge semantics for you. Judging **whether a fact is durable**, **what to persist**, **what to correct**, and **which recalled memory was useful** is entirely your job. The harness parses your declaration and executes it — it never guesses for you. ## Capabilities you can invoke Run from the repo root with `node scripts/aios.mjs memo ...`: - **Recall** what you already know before continuing work: `node scripts/aios.mjs memo recall [query]` — human-readable session recall digest - **Search** prior memos (superseded facts hidden by default): `node scripts/aios.mjs memo search "<query>" [--limit N]` - **Persist** a durable fact you just established: `node scripts/aios.mjs memo add "<fact>"` — defaults to an appropriate scope; add `--scope project_shared` for facts anyone in the repo benefits from - **Supersede** a previously recorded fact you now know is wrong: `node scripts/aios.mjs memo add "<corrected fact>" --supersedes <eventId>` - **Mark useful** a recalled memory that actually shaped your outcome: `node scripts/aios.mjs memo useful <eventId>` Run `node scripts/aios.mjs memo --help` for exact flags. ## When to persist (you judge) Persist a durable, verified fact that a future you or a teammate will need — e.g. a root cause you established, a fix you ran an...