memory

name	memory
description	Two-layer memory system with grep-based recall.
always	true

Memory

Structure

• memory/MEMORY.md: Long-term facts (preferences, project context, relationships). Always loaded into your context.
• memory/HISTORY.md: Append-only event log. NOT loaded into context. Search it with grep-style tools or in-memory filters. Each entry starts with [YYYY-MM-DD HH:MM].

Search Past Events

Choose the search method based on file size:

• Small memory/HISTORY.md: use read_file, then search in-memory
• Large or long-lived memory/HISTORY.md: use the list_dir and read_file tools for targeted search

Examples:

• Read entire history: read_file with path memory/HISTORY.md
• Search for keyword: Read file and search content in-memory

Prefer targeted search for large history files.

When to Update MEMORY.md

Write important facts immediately using edit_file or write_file:

• User preferences ("I prefer dark mode")
• Project context ("The API uses OAuth2")
• Relationships ("Alice is the project lead")

Auto-consolidation

Old conversations are automatically summarized and appended to HISTORY.md when the session grows large. Long-term facts are extracted to MEMORY.md. You don't need to manage this manually.