git404hub

what is amnesia fr?

tiny-cloud-ventures/amnesia — explained in plain English

Analysis updated 2026-05-18

5PythonAudience · developerComplexity · 2/5LicenseSetup · easy

tl;dr

A local tool that scans, cleans, and organizes the memory files Claude Code saves about your projects, catching stale or contradictory notes.

vibe map

mindmap
  root((Amnesia))
    What it does
      Scans Claude Code memory
      Flags contradictions and duplicates
      Lets you review and fix
    Tech stack
      Python
      Claude CLI
      Local web UI
    Use cases
      Cleaning stale AI memory
      Merging duplicate project notes
      Visualizing memory connections
    Audience
      Developers
      Claude Code users
      Vibe coders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Clean up stale or contradictory memory files Claude Code has saved over time.

VIBE 2

Merge duplicate notes that were saved across multiple projects.

VIBE 3

Visualize how your saved AI memories connect to each other.

VIBE 4

Move a misfiled memory into the project it actually belongs to.

what's the stack?

PythonClaude CodeCLI

how it stacks up fr

tiny-cloud-ventures/amnesia1ncendium/aibusteraaronmayeux/ha-hurricane-tracker
Stars555
LanguagePythonPythonPython
Setup difficultyeasymoderateeasy
Complexity2/53/52/5
Audiencedeveloperops devopsgeneral

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Requires Python 3.9 or later and an existing Claude CLI subscription for the scan step.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

in plain english

Amnesia is a tool for cleaning up the memory that Claude Code, an AI coding assistant, quietly saves about your projects over time. Claude Code stores memory files under a folder on your computer, and over months those files can build up problems: facts that used to be true but no longer are, the same note saved in three different projects, and memories from one project accidentally showing up in another. This kind of buildup is sometimes called memory contamination, and according to the README, research shows that messy memory can actually make an AI agent perform worse than having no memory at all. Amnesia works in a simple loop. It counts how many memories and projects it finds in your store, then runs a scan that feeds your whole memory store to your own Claude CLI, which flags contradictions, outdated facts, duplicate notes, and memories that seem to be filed under the wrong project. You then review each flagged item one at a time in plain language, choosing to forget it, move it to a different project, combine it with another, or keep both. If you are in a hurry, a fix all option previews all the confident changes at once and applies them together. Every change is reversible, since Amnesia keeps a backup snapshot before altering anything. The project also includes a visual map of your memory store, showing each memory as a dot connected by lines, with contradictions highlighted after a scan. Amnesia can be installed as a Claude Code plugin, run as a command line tool using uvx, or downloaded as a single Python file with no extra dependencies. It runs entirely on your own machine, with no accounts, API keys, or telemetry involved, and nothing is permanently deleted since removed files move to a local trash folder. It requires Python 3.9 or later and is released under the MIT license, which allows free use including commercial use.

prompts (copy fr)

prompt 1
Show me how to install Amnesia as a Claude Code plugin.
prompt 2
Explain how Amnesia decides a memory is stale or contradictory.
prompt 3
Walk me through running an Amnesia scan and reviewing the flagged items.
prompt 4
Help me run Amnesia as a standalone Python file with no other dependencies.

Frequently asked questions

what is amnesia fr?

A local tool that scans, cleans, and organizes the memory files Claude Code saves about your projects, catching stale or contradictory notes.

What language is amnesia written in?

Mainly Python. The stack also includes Python, Claude Code, CLI.

What license does amnesia use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is amnesia to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is amnesia for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.