Explain how claude-mem captures observations, when memory injection kicks in, and where data lives. Use when the user asks "how does claude-mem work?" or "what is this thing doing?".
Every Read, Edit, and Bash that Claude makes turns into a compressed observation. Observations get summarized at session end. Relevant ones get auto-injected into future prompts so the next session starts with context from the last one — no re-explaining the codebase, no re-discovering decisions.
Memory injection starts on your second session in a project.
The first session in a fresh project seeds memory; subsequent sessions receive auto-injected context for relevant past work. Run /learn-codebase if you want to front-load the entire repo into memory in a single pass (~5 minutes, optional).
Everything stays in ~/.claude-mem on this machine.
Nothing leaves your machine except calls to whichever AI provider you configured for compression (Claude / OpenRouter / Gemini). Local installs contact cmem.ai once, at signup, to create the sign-in link; nothing else is sent to cmem.ai. The SQLite database, vector index, logs, and settings all live under that directory and are removed cleanly on npx claude-mem uninstall.
Copy a source-pinned command for your client. You run it yourself.
Destination: .claude/skills/how-it-works · pinned to the source commit
# Run from your project root
git clone https://github.com/thedotmack/claude-mem.git .skillboard-tmp
git -C .skillboard-tmp checkout fef3402e674bebbf72a23aeb735e91c92cd34afd
mkdir -p ".claude/skills"
cp -r ".skillboard-tmp/plugin/skills/how-it-works" ".claude/skills/"
rm -rf .skillboard-tmpReview the source before running. This copies files into your project; it is not a one-click install and does not verify runtime safety.
sudo apt update && sudo apt install -y gitnpm install -g @anthropic-ai/claude-code# Run from your project root
git clone https://github.com/thedotmack/claude-mem.git .skillboard-tmp
git -C .skillboard-tmp checkout fef3402e674bebbf72a23aeb735e91c92cd34afd
mkdir -p ".claude/skills"
cp -r ".skillboard-tmp/plugin/skills/how-it-works" ".claude/skills/"
rm -rf .skillboard-tmpDestination: .claude/skills/how-it-works
Scanner static-checks@0.1.0 · commit fef3402e674b. Static checks cannot prove runtime safety – review the source and the exact diff before installing. How checks work.
No static rules matched. This is not a safety guarantee.