How Memory Grows

Memory is a set of Markdown files under ~/.klaus/agent-memory on this machine. MEMORY.md is the index (shown in the UI as the "memory directory"), and each memory entry is its own .md file whose filename prefix is its category: user_* (about you), feedback_* (your preferences), project_* (what you are working on), reference_* (related material). Files without one of these four prefixes are shown in the UI by their plain filename.

There are two write paths:

• Dreaming: off by default. Once enabled, it runs in the background when at least 5 new sessions have accumulated and 24 hours have passed since the last dream, gathering what is worth keeping from recent sessions into memory files. You can also trigger it manually from the memory page (a manual trigger ignores both thresholds). Once it starts, it cannot be stopped.
• Per-turn saving: off by default. Once enabled, it writes at the end of every turn.

Both switches are off by default, so a fresh Klaus installation does not grow memory on its own: turn on the first one if you want memories captured as they happen, and the second if you want them consolidated into an organized set. Dreaming is the act of gathering scattered memories into that organized set — it is not a replacement for the switch itself.

Because memory is just plain text files, you can open, edit, or delete them directly in Finder.