# Memory

> Agent memory files with grep-based scoped recall.

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

---


# Memory

## Structure

- `.agent/main/MEMORY.md` — Core memory: user preferences, stable facts, decisions, known issues.
- `.agent/main/PROJECT_MEMORY.md` — Project facts, build/run notes, files/architecture, project decisions and issues.
- `.agent/main/SESSION_SUMMARY.md` — Current goal, recent progress, and open issues.
- `.agent/main/HISTORY.jsonl` — Consolidated action history. Search it when older details are needed.
- `.agent/main/SESSION.jsonl` — Crash-safe session tail. Do not edit manually.

Sub-agents use `.agent/subagents/<id>/...` for scoped memory.

## When to Update Memory

Write important facts immediately using `edit_file`:
- User preferences ("I prefer dark mode")
- Project context ("The API uses OAuth2")
- Relationships ("Alice is the project lead")

Put transient task state in `SESSION_SUMMARY.md`, not `MEMORY.md`.

## Auto-consolidation

Old conversations are automatically summarized into `HISTORY.jsonl` and the memory markdown files when the session grows large. You usually don't need to manage this.