Memory

Structure

• 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.

Search Past Events

memory/history.jsonl is JSONL format — each line is a JSON object with cursor, timestamp, content.

• For broad searches, start with grep(..., path="memory", glob="*.jsonl", output_mode="count") or the default files_with_matches mode before expanding to full content
• Use output_mode="content" plus context_before / context_after when you need the exact matching lines
• Use fixed_strings=true for literal timestamps or JSON fragments
• Use head_limit / offset to page through long histories
• Use exec only as a last-resort fallback when the built-in search cannot express what you need