Total Recall
A memory system for Claude Code that remembers what matters and forgets what doesn't.
The Problem
Claude Code forgets everything between sessions. Every time you start a new conversation, it's like talking to someone with amnesia. You end up repeating yourself:
- "We already tried that approach, it didn't work."
- "Don't touch the auth file."
- "I prefer tabs over spaces."
- "The client's name is Sarah, not Sara."
This gets old fast.
What Total Recall Does
It gives Claude Code a notepad that carries over between sessions, but a picky notepad. Not everything goes in. Before anything gets saved permanently, it has to pass a simple test: will this matter tomorrow?
A preference you'll have for months? Saved. A decision you made and why? Saved. The fact that you ran a test five minutes ago? Not saved. The system keeps itself clean so Claude isn't wading through junk to find what's relevant.
How It Works
Think of it like a kitchen with four storage areas:
Counter (CLAUDE.local.md): The stuff you reach for every day. Loads automatically, every session. Kept small on purpose, around a page of text.
Pantry (memory/registers/): Organized by category. Your preferences, key decisions, project details, people you work with. Claude checks here when it needs something specific.
Daily notebook (memory/daily/): Timestamped scratch notes from each day. Everything gets written here first. You decide later what's worth keeping permanently.
Storage closet (memory/archive/): Old stuff that's done or outdated. Still searchable, but never loaded automatically.
The key idea: notes hit the daily notebook first, then you promote the keepers. Claude doesn't get to decide on its own what's important enough to remember permanently. You do.
Quick Start
Install as a plugin (recommended)
/plugin marketplace add davegoldblatt/recall-marketplace
/plugin install recall@recall-marketplace
Or install standalone
git clone https://github.com/davegoldblatt/total-recall.git
cd total-recall
./install.sh /path/to/your/project
After installing, restart Claude Code or run /hooks to activate.
Using It
Here's your day-to-day:
Claude notices something worth remembering. It writes to your daily notebook and tells you. You don't have to do anything.
You want Claude to remember something. Just say "remember this" or use the write command:
/recall-write Dave prefers concise error messages, no stack traces in prod
End of day (or whenever). Review what piled up and promote the good stuff:
/recall-promote
Find something from last week. Search across everything:
/recall-search authentication decision
You correct Claude. The correction updates everywhere at once: daily notebook, registers, and the counter. The same mistake won't happen again.
All Commands
| Command | What it does |
|---|
/recall-init | Set up the memory folders for the first time |
/recall-write <note> | Save a note (checks if it's worth keeping, suggests where) |
/recall-log <note> | Quick note to the daily notebook, no questions asked |
/recall-search <query> | Search everything |
/recall-promote | Review daily notes, move the keepers to registers |
/recall-status | Health check. Is everything working? |
/recall-maintain | Clean up stale or duplicate entries |
/recall-forget <query> | Mark something as outdated |
/recall-context | Show what memory Claude has loaded right now |
If installed as a plugin, commands are namespaced: /recall:recall-write instead of /recall-write.
The Write Gate
This is the core idea. Before anything gets promoted to permanent memory, it has to pass at least one of these checks:
- Will it change how Claude behaves next time? (a preference, a boundary, a pattern)
- Is it a commitment someone's counting on? (a deadline, a deliverable, a follow-up)
- Is it a decision worth remembering the reasoning for? (why you picked X over Y)
- Is it a stable fact that'll come up again? (not something that'll be different tomorrow)
- Did you explicitly say "remember this"?
If none of those are true, it stays in the daily notebook and eventually ages out. This keeps memory lean. No junk drawer.
When Corrections Happen
If you tell Claude it got something wrong, it doesn't just say "sorry" and move on. It updates the daily notebook, the relevant register, and the counter, all in one shot. The old information gets marked as superseded (not deleted) so there's a trail of what changed and when.
What Loads Automatically
Only two things, every session:
| What | Where | How |
|---|
| The rules (write gate, correction protocol) | rules/total-recall.md | Claude Code loads all rules files automatically |
| Counter / working memory | CLAUDE.local.md | Claude Code loads this automatically |
