thedotmack/claude-mem/how-it-works
Claude Code and agent skill by thedotmack/claude-mem
- community
Checking that the SKILL.md file is still in the repository.
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?".
Install
npx vskill@latest install thedotmack/claude-mem/how-it-worksSKILL.md
The same SKILL.md was published earlier as thedotmack/claude-mem/how-it-works.
How claude-mem works
What it does
While you work, an observer (a second agent) watches what your agent reads, edits and runs, and writes short notes about what mattered. Those notes are called observations. When a session ends, the observer writes a summary. When the next session starts, your agent gets a compact index of the observations that matter for this project and fetches full details only when it needs them.
So the next session starts where the last one left off: no re-explaining the codebase, no re-discovering decisions.
When it kicks in
Memory injection starts on your second session in a project.
The first session seeds memory as you work. To front-load a whole repo in one pass instead, run /learn-codebase (~5 minutes on a typical repo, optional).
Where data lives
Your memory lives in ~/.claude-mem on this machine: the SQLite database, vector index, logs and settings. npx claude-mem uninstall removes it.
What leaves the machine:
- What the observer reads goes to the model you chose to run it: your Claude plan unless you picked another provider (Codex, OpenRouter, Gemini, or the claude-mem observer on CMEM Pro).
- During install, cmem.ai gets only your email and optional note if you share them when the installer asks (it's optional and asked once), and a numbers-only usage summary (observation counts and token totals; no prompts, paths, or project names) when setup creates a sign-in link. Nothing else goes to cmem.ai unless you sign in and turn on something that uses it (cloud sync, CMEM Pro's hosted observer, a provider that runs through your cmem.ai account) or choose to upload your prompts during browser setup.
- Anonymous usage analytics (telemetry) are on by default. Turn them off with
npx claude-mem telemetry disable, or setDO_NOT_TRACK=1.
Security
- Security scanPassed, 100 of 100Pattern checks on the skill's files.
- Model reviewNot runA model review is scheduled for the next rescan.
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingplugin/skills/how-it-works/SKILL.md
Popularity
- Repository stars
- 77,336
- Repository forks
- 6,659
- Repository npm downloads, 7 days
- 15,704
- 7-day trend score
- 79
Stars and forks are for the whole GitHub repository, not this skill alone. Downloads are for the repository's npm package. Refreshed 22 May 2026, 6 months ago.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/thedotmack/claude-mem/how-it-works)