# Memory

> Memory system with daily logs and keyword search. Use to save facts, search past events, or recall user preferences and project context across conversations.

- Skill: `ionclaw-org/memory` (Agent Skill)
- Install (CLI): `npx skillmds@latest add ionclaw-org/memory`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ionclaw-org/memory/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ionclaw-org (https://skillmd.com/u/ionclaw-org)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/ionclaw-org/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.