GitHub - tiny-cloud-ventures/amnesia: Give your agent selective amnesia — see, search, and clean Claude Code's memory across all your repos · GitHub
/" data-turbo-transient="true" />
Skip to content
Search or jump to...
Search code, repositories, users, issues, pull requests...
-->
Search
Clear
Search syntax tips
Provide feedback
--><br>We read every piece of feedback, and take your input very seriously.
Include my email address so I can be contacted
Cancel
Submit feedback
Saved searches
Use saved searches to filter your results more quickly
-->
Name
Query
To see all available qualifiers, see our documentation.
Cancel
Create saved search
Sign in
/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up
Appearance settings
Resetting focus
You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.
Dismiss alert
{{ message }}
Uh oh!
There was an error while loading. Please reload this page.
tiny-cloud-ventures
amnesia
Public
Notifications<br>You must be signed in to change notification settings
Fork
Star
main
BranchesTags
Go to file
CodeOpen more actions menu
Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit
History<br>11 Commits<br>11 Commits
.claude-plugin
.claude-plugin
commands
commands
docs
docs
.gitignore
.gitignore
CHANGELOG.md
CHANGELOG.md
CONTRIBUTING.md
CONTRIBUTING.md
LICENSE
LICENSE
README.md
README.md
amnesia.py
amnesia.py
pyproject.toml
pyproject.toml
View all files
Repository files navigation
Give your agent selective amnesia. See, search, and clean every memory Claude Code has saved about you — and let Claude audit its own memory for contradictions.
The counts are live, not fixed. Amnesia discovers every saved memory under ~/.claude/projects/*/memory/ and reports the actual total for your store. The screenshot below is one real store, not a limit.
Every dot is one memory, colors are projects, lines are the references between them — contradictions glow red after a scan. Live, draggable, and clickable in the built-in UI.
Claude Code quietly accumulates memory files per project directory under ~/.claude/projects/*/memory/. Over months that store rots: facts go stale ("service X is live" — it was retired weeks ago), the same rule gets saved three times in three projects, and memories from one project leak into sessions for another. Research on agent memory calls this memory contamination, and polluted memory measurably makes agents worse than no memory at all.
amnesia is one sentence, one button, one question at a time:
Open it: Amnesia counts your store live and tells you exactly how many memories and projects it found. One button: Scan .
The scan feeds your whole store to your own claude CLI and flags contradictions , stale facts , duplicates , and misfiled memories .
Review walks you through the flags one at a time, in plain language — "These can't both be true", "This seems filed in the wrong project" — with one-word answers: Forget, Move it, Combine them, Keep both. Decisions survive reloads until the next successful scan, which asks again from fresh evidence. In a hurry? Fix all previews every confident consolidation, then applies them as one undoable batch.
Every change is reversible: Amnesia snapshots each affected memory and index before changing it. Undo is right there in the toast and under Recent changes ; it refuses to overwrite a file you edited afterward.
Search, a browse-everything view with project filters, date/size sorting, and the map — the live force-graph above, physics hand-rolled in ~100 lines of dependency-free canvas — are each one click away, never the default.
Install
As a Claude Code plugin — you already have everything it needs:
/plugin marketplace add tiny-cloud-ventures/amnesia<br>/plugin install amnesia@amnesia
Then /amnesia:open opens the UI, and /amnesia:scan audits your memory without leaving the session.
As a CLI (requires Python 3.9+):
uvx --from git+https://github.com/tiny-cloud-ventures/amnesia amnesia
Or the zero-tooling way — it's a single file, stdlib only:
curl -O https://raw.githubusercontent.com/tiny-cloud-ventures/amnesia/main/amnesia.py<br>python3 amnesia.py
Use
amnesia # UI at http://localhost:8780 — scan, review, done<br>amnesia analyze # same audit, from the terminal<br>amnesia 9000 # different port
Or, with the plugin: /amnesia:open and /amnesia:scan.
Yours, local, reversible
Nothing leaves your machine. The UI binds to localhost only. No accounts, no API keys, no telemetry, no server. Changes require a same-session, same-origin JSON request.
The only thing that ever reads your memories is the Claude account you already use. The scan pipes your store through your own claude CLI — the same subscription Claude Code runs on.
Nothing is ever deleted. Forgotten and merged source files move to...