gitwtfhub

wtf is claude-mem?

thedotmack/claude-mem — explained in plain English

Analysis updated 2026-05-18

72,874TypeScriptAudience · developerComplexity · 3/5LicenseSetup · moderate

TL;DR

A plugin that gives Claude Code persistent memory across sessions by recording your work, summarizing it with AI, and automatically surfacing relevant context in future sessions.

Mindmap

mindmap
  root((repo))
    What it does
      Persistent memory
      Auto-summarization
      Context injection
    How it works
      Hooks into Claude Code
      Vector database storage
      Semantic search
    Use cases
      Long-running projects
      Multi-project switching
      Avoid re-explaining
    Tech stack
      TypeScript
      Node.js
      ChromaDB
    Features
      Web interface
      Search skill
      Project-scoped

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

Resume work on long-running projects without re-explaining project structure or past decisions to Claude.

REASON 2

Switch between multiple projects and have Claude automatically recall relevant context for each one.

REASON 3

Browse your entire work history and search past sessions through a local web interface.

What's in the stack?

TypeScriptNode.jsChromaDBClaude SDK

How it stacks up

thedotmack/claude-memapache/supersetabi/screenshot-to-code
Stars72,87472,71572,451
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatehardhard
Complexity3/54/53/5
Audiencedeveloperdatadeveloper

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

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires Claude API key and ChromaDB setup, plugin installation into Claude Code environment may need configuration.

Use freely for any purpose including commercial. Keep the notice and disclose changes to the patent grant.

Wtf does this do

Claude-Mem is a plugin for Claude Code, Anthropic's AI coding assistant, that gives it a persistent memory across separate work sessions. Normally when you close a Claude Code session and start a new one, the AI has no memory of what you worked on before. Claude-Mem solves this by automatically recording what Claude does during each session, compressing those observations into concise summaries using AI, and then injecting the most relevant pieces of that history back into future sessions so Claude has context about your project without you needing to re-explain everything. The system works by hooking into Claude Code's plugin system. A background worker process monitors each session, captures tool usage and observations, and stores them in a local database using ChromaDB, which is a vector database that allows semantic search. When a new session starts, the plugin retrieves the most relevant past observations based on what you are currently working on and surfaces them at the top of the context. There is also a web interface running locally that lets you browse your memory stream in real time, and a search skill that lets you explicitly query past work. You would use this if you work on long-running projects with Claude Code and find yourself constantly re-explaining project structure, past decisions, or ongoing tasks at the start of each session. It is also useful when switching between multiple projects, since the memory is project-scoped. The plugin supports Claude Code, Gemini CLI, and OpenCode. The tech stack is TypeScript running on Node.js 18 or later, with ChromaDB for vector storage and Claude's own agent SDK used to perform the AI-powered compression and summarization of observations. Installation is a single npx command.

Yoink these prompts

Prompt 1
Install claude-mem and set it up to track my Claude Code sessions, then show me how to view my memory stream in the web interface.
Prompt 2
How do I configure claude-mem to be project-scoped so it only surfaces memories relevant to my current project?
Prompt 3
Use the search skill in claude-mem to find all observations from my past sessions about database schema decisions.
Prompt 4
Show me how claude-mem compresses and summarizes my work observations using AI so I can understand what context it will inject into future sessions.

Frequently asked questions

wtf is claude-mem?

A plugin that gives Claude Code persistent memory across sessions by recording your work, summarizing it with AI, and automatically surfacing relevant context in future sessions.

What language is claude-mem written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, ChromaDB.

What license does claude-mem use?

Use freely for any purpose including commercial. Keep the notice and disclose changes to the patent grant.

How hard is claude-mem to set up?

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

Who is claude-mem for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

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