Skill guide · checked November 19, 2026
claude-mem Skills: Install and Use
Short answer: claude-mem is an open-source memory plugin that records what your coding agent does and brings relevant notes back in the next session. It ships 30 bundled skills, such as mem-search, alongside hooks and a local worker. Install it with npx claude-mem install, or inside Claude Code with /plugin marketplace add thedotmack/claude-mem and /plugin install claude-mem.
Want the tool itself first? Read claude-mem: Persistent Memory for Claude Code, Codex and Antigravity.
Install the claude-mem skills
The README Quick Start gives the installer first and the Claude Code marketplace as an alternative. It warns that npm install -g claude-mem installs only the library and does not register the hooks.
npx claude-mem install
# or inside Claude Code
/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem
# one specific agent, for example the Antigravity CLI
npx claude-mem install --ide antigravity
# if something looks wrong
npx claude-mem doctorSource: thedotmack/claude-mem and the official docs. We do not host a copy, so you always install the current version.
What each claude-mem skill does
claude-mem is mainly a plugin; the skills are one part of it. The repository folder plugin/skills contains 30 skills, and the table lists 13 that look most useful. See the repository for the rest. Descriptions are in our words from each skill file, and the "use when" column is our reading.
| Skill | What it does | Use when |
|---|---|---|
mem-search | Searches the stored memory of past sessions in three steps: search, timeline, then fetching chosen details. | You wonder whether a problem was already solved before. |
how-it-works | Explains what claude-mem records, when it injects memory and where the data is kept. | You want to understand what the plugin is doing. |
smart-explore | Explores code structure through syntax-tree search instead of reading whole files. | You need a map of unfamiliar code without spending many tokens. |
make-plan | Writes a phased implementation plan, with documentation lookups, that later chats can execute. | A feature needs a plan before any code. |
do | Carries out a phased plan by handing the work to subagents. | You already have a plan, for example from make-plan. |
learn-codebase | Primes the agent by having it read every source file in a project. | Starting on a project you or the agent do not know yet. |
handoff | Writes a HANDOFF.md with the goal, state, failed attempts and next steps so a fresh session can continue. | A session has grown long or the agent keeps repeating a broken fix. |
timeline-report | Builds a narrative report of a project's development history from the stored timeline. | You want a history of how a project evolved. |
knowledge-agent | Compiles stored observations into a focused knowledge base you can question in conversation. | You want answers about patterns in your past work. |
agent-cost-report | Produces an estimated agent cost report for a period from your session transcripts. | You want to see roughly what your agent usage costs. |
backup-setup | Sets up, checks or restores local snapshots of the memory database. | You want a backup of your stored memories. |
cloud-sync | Sets up or checks syncing of memory with a cmem.ai Pro account. | You want memory shared across machines through the hosted service. |
babysit | Keeps watching a pull request until comments and checks are resolved. | A PR needs follow-up through review and CI. |
Install and check that memory works
From the README Quick Start and Requirements. It needs Node.js 20.19 or later in the 20.x line, or 22.12 or later; the README says Bun and uv are installed automatically if missing.
- Run
npx claude-mem install. The installer finds the agents on your machine and asks which to set up. - Handle the sign-in step. The README says it offers a browser sign-in and a 30 day trial of a hosted observer that asks for a payment method, and that you can pass
--provideror setCLAUDE_MEM_ONLINE_OPTIN=falseto skip account interaction. - Restart your agent, then work as usual. The README says observations stream in from the first prompt.
- Open a second session in the same project; it should start with memory from the first. If not, run
npx claude-mem doctor.
License and what we did not verify
We checked the LICENSE file on November 19, 2026: it is the Apache License 2.0, and the README says so too. The repository's docs/license.md says Apache-2.0 covers the open-source core, while hosted cloud, team sync and similar commercial areas are kept outside it. The README also says anonymous usage analytics are on by default and can be turned off, that memory is stored in ~/.claude-mem and that cloud sync is opt-in. We did not verify the hosted-service pricing beyond what the README states. We have not run claude-mem or its skills ourselves; every command and description comes from the repository files. Confirm them there before relying on them. See also how to install skills in Antigravity, Claude Code and Codex and our full Skills library.
FAQ
What is claude-mem?
It is a memory plugin by thedotmack. A second agent takes notes while your main agent works, and the next session starts with a short index of what matters. It is not one skill: it includes hooks, a local worker and bundled skills.
How do I install claude-mem?
Run npx claude-mem install, or inside Claude Code use /plugin marketplace add thedotmack/claude-mem followed by /plugin install claude-mem. Do not rely on npm install -g, which the README says installs the library only.
Which agents does claude-mem support?
The README names Claude Code, Codex, Cursor and OpenCode plus 11 more. It adds that Copilot CLI, Goose, Roo Code, Warp and Zed can search memory but their sessions are not recorded. An Antigravity CLI install option also exists.
Is claude-mem free?
The code is Apache-2.0. The README describes memory providers including your own OpenRouter or Gemini key or your Anthropic plan, and a hosted observer with a 30 day free trial that asks for a payment method. Read the README before choosing.
Does claude-mem send my data anywhere?
The README says memory lives on your machine in ~/.claude-mem and cloud sync is opt-in. Anonymous usage analytics are on by default and npx claude-mem telemetry disable turns them off.
