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

Examples (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)

Important

• Do NOT edit SOUL.md, USER.md, or MEMORY.md. They are automatically managed by Dream.
• If you notice outdated information, it will be corrected when Dream runs next.
• Users can view Dream's activity with the

  /dream-log

  command.