Two-layer memory system with Dream-managed knowledge files.
SOUL.md — Bot personality and communication style. Managed by Dream. Do NOT edit.USER.md — User profile and preferences. Managed by Dream. Do NOT edit.memory/MEMORY.md — Long-term facts (project context, important events). Managed by Dream. Do NOT edit.memory/history.jsonl — append-only JSONL, not loaded into context. Prefer the built-in grep tool to search it.memory/history.jsonl is JSONL format — each line is a JSON object with cursor, timestamp, content.
grep(..., path="memory", glob="*.jsonl", output_mode="count") or the default files_with_matches mode before expanding to full contentoutput_mode="content" plus context_before / context_after when you need the exact matching linesfixed_strings=true for literal timestamps or JSON fragmentshead_limit / offset to page through long historiesexec only as a last-resort fallback when the built-in search cannot express what you needExamples (replace keyword):
grep(pattern="keyword", path="memory/history.jsonl", case_insensitive=true)grep(pattern="2026-04-02 10:00", path="memory/history.jsonl", fixed_strings=true)grep(pattern="keyword", path="memory", glob="*.jsonl", output_mode="count", case_insensitive=true)grep(pattern="oauth|token", path="memory", glob="*.jsonl", output_mode="content", case_insensitive=true)/dream-log command.