# Memory

> Two-layer memory system with grep-based recall.

- Skill: `modalitydance/memory` (Agent Skill)
- Install (CLI): `npx skillmds@latest add modalitydance/memory`
- Raw SKILL.md: https://api.skillmd.com/api/skills/modalitydance/memory/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ModalityDance (https://skillmd.com/u/modalitydance)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/modalitydance/memory

---


# Memory

## Structure

- `memory/MEMORY.md` — Long-term facts (preferences, project context, relationships).
- `memory/HISTORY.md` — Append-only event log. Search it by keyword.

## Search Past Events

Use file tools to search `memory/HISTORY.md` by keyword/regex.

## When to Update MEMORY.md

Write important facts immediately:
- User preferences
- Project context
- Key relationships

## Auto-consolidation

Older conversation turns can be summarized into HISTORY and MEMORY by consolidation logic.