ionclaw-org/ionclaw/memory

Memory

Structure

• memory/MEMORY.md -- Long-term curated facts (preferences, project context). Always loaded into your context.
• memory/YYYY-MM-DD.md -- Daily logs. Append-only, one file per day. Search them with memory_search.

Save Memories

Use memory_save to store durable facts and context. Content is appended to today's daily log automatically:

memory_save(content="User prefers dark mode. Project uses OAuth2 for auth.")

Search Past Events

Use memory_search to find information across all memory files:

memory_search(query="keyword")

Returns matching lines with surrounding context, indicating which file each match came from.

Read Memory Files

Use memory_read to read a specific memory file:

memory_read(file="MEMORY.md")
memory_read(file="2026-03-13.md")
memory_read(file="2026-03-13.md", max_lines=50)
memory_read(file="list")

Use file="list" to see all available memory files.

Pre-Compaction Flush

When the conversation context approaches its limit, durable facts are automatically saved to today's daily log before compaction. MEMORY.md is not modified automatically.