gitwtfhub

wtf is deep-memory?

kevintsai1202/deep-memory — explained in plain English

Analysis updated 2026-05-18

36PythonAudience · developerComplexity · 3/5Setup · moderate

TL;DR

A background memory skill for AI coding assistants that recalls past solutions, learns from completed tasks, and stores that knowledge for reuse across future sessions.

Mindmap

mindmap
  root((repo))
    What it does
      Persistent AI memory
      Recalls past solutions
      Auto-captures lessons
    Tech stack
      Python
      ChromaDB
      BGE-Reranker
    Storage design
      Hot store
      Cold store
      GitHub backup
    Audience
      AI agent developers
      Claude Code users

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

Why would anyone build with this?

REASON 1

Give an AI coding assistant persistent memory of past solutions across sessions.

REASON 2

Automatically capture the working approach after a coding task succeeds without manual notes.

REASON 3

Recall skill-specific pitfalls, like a parameter that caused a bug, the next time that tool is used.

REASON 4

Back up and restore an AI assistant's accumulated knowledge base to a private GitHub repository.

What's in the stack?

PythonChromaDBBGE-RerankerClaude Code

How it stacks up

kevintsai1202/deep-memoryakmessi/vexdinosn/wp2shell-lab
Stars363636
LanguagePythonPythonPython
Setup difficultymoderatemoderatemoderate
Complexity3/53/54/5
Audiencedevelopervibe coderresearcher

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

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires installing the skill into an AI agent's skill folder plus local Python dependencies for the hybrid search component.

Not sufficiently specified in the provided material.

Wtf does this do

Deep-Memory is a skill for AI coding assistants, such as Claude Code or Codex, that gives them long-term memory across separate conversations. Normally an AI assistant forgets everything once a session ends. This project runs in the background, automatically pulling up relevant past experience during a conversation, and once a task is finished successfully, it writes the approach that worked into a private knowledge base so it can be reused later. The README describes it as a restructured and renamed version of an earlier project called auto-skill, rebuilt to separate code from stored data and to add local hybrid search. The README describes a five step loop that runs on every conversation turn: extracting keywords to fingerprint the current topic, detecting whether the topic has changed and the knowledge base needs rereading, checking for skill-specific pitfall notes if a particular tool was used, retrieving matching general knowledge base entries, and finally writing back a summary once a task appears complete. It also describes cross-skill memory, where invoking one tool can trigger a reminder based on something learned during a past use of that same tool, and proactive capture, where the assistant asks whether to save a solution once a problem seems solved rather than requiring the user to take notes manually. Technically, retrieval combines semantic search with keyword based BM25 search through a local ChromaDB database, re-ranked using a model called BGE-Reranker-base that runs on the CPU. Knowledge is split into a hot store of curated, indexed entries and a cold store of raw, unrefined notes that get promoted into the hot store once enough accumulate. A separate backup component can push the knowledge base to a private GitHub repository and restore it on another machine, checking first whether the remote copy is newer so devices do not silently overwrite each other. Installation can be done three ways: copying the skill files into an AI agent's global skill folder so every project shares one knowledge store, using a quick install command that fetches the package from GitHub directly into that global folder, or copying the skill folder into a single project for a self-contained setup. By default all of a user's knowledge is stored under a folder in their home directory shared across projects, though this can be changed to keep separate stores per project.

Yoink these prompts

Prompt 1
Walk me through installing deep-memory globally for Claude Code.
Prompt 2
Explain the five step loop deep-memory runs on each conversation turn.
Prompt 3
Explain the difference between the hot store and cold store in deep-memory's knowledge base.
Prompt 4
Help me set up the memory-backup sub-skill to push my knowledge base to a private GitHub repo.
Prompt 5
Explain how deep-memory's hybrid retrieval combines semantic search with BM25 keyword search.

Frequently asked questions

wtf is deep-memory?

A background memory skill for AI coding assistants that recalls past solutions, learns from completed tasks, and stores that knowledge for reuse across future sessions.

What language is deep-memory written in?

Mainly Python. The stack also includes Python, ChromaDB, BGE-Reranker.

What license does deep-memory use?

Not sufficiently specified in the provided material.

How hard is deep-memory to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is deep-memory for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.