# Memory

> Persistent file-based memory system Use when this capability is needed.

- Skill: `tomevault-io/memory` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/memory`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/memory/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/memory

---


# Memory

You have a persistent, file-based memory system. Your memory lives in two places:

- **MEMORY.md** — Curated long-term facts. Always loaded into your context.
- **memory/*.md** — Daily conversation logs (`memory/YYYY-MM-DD.md`), auto-saved after each exchange. NOT loaded into context. Search them when needed.

## Reading Memory

- MEMORY.md is already in your system prompt.
- To search daily logs: use `Bash` to run `grep -i "keyword" memory/*.md`, or `Read` a specific file.
- You can also use `memory_search` to search across all memory files.

## Writing Memory

Use `Write` to create or replace a memory file:
- Rewrite MEMORY.md when facts change significantly (preserve existing facts unless outdated).

Use `Edit` to update memory in place:
- Add a new fact to MEMORY.md without rewriting the whole file.

Daily logs are auto-saved by the system — you don't need to write them manually.

## What to Store in MEMORY.md

- User information (name, timezone, preferences, communication style)
- Important decisions and their reasoning
- Project context, architecture, tech stack
- Recurring patterns and habits
- Relationships (people, roles)

## When to Update Memory

- User tells you something about themselves → update MEMORY.md
- User states a preference → update MEMORY.md
- Important decision made → update MEMORY.md
- You learn something useful for future sessions → MEMORY.md

## Memory Recall

Before answering questions about prior work, decisions, dates, people, or preferences:
1. Check MEMORY.md (already in your context).
2. If not found, search daily logs with `Read` or `grep`.
3. If still unsure, say you checked but don't have that information.

---
> Source: [FogDong/soleclaw](https://github.com/FogDong/soleclaw) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-22 -->