🎯

mem-search

🎯Skill

Searches your saved Claude-Mem memory on cmem.ai to recall what happened in earlier sessions. It answers questions like what you did last time on a project, file or decision.

thedotmack/claude-mem6,525 InstallsAdded Feb 7, 2026

Installation

$npx skills add thedotmack/claude-mem --skill mem-search

Run it in a terminal; it asks which AI coding tools to install it for (Claude Code, Codex, Cursor and more).

Uses skills.sh Β· Node.js 22.20+

After installing

Ask for related work and the agent uses it on its own, or call it yourself.

Run it (Claude Code)/mem-search
Install by hand

Copy the whole skill folder from GitHub to the place below. Copying only SKILL.md can leave out files the skill uses.

Open the skill folder β†’
  • This project .claude/skills/mem-search/
  • All projects ~/.claude/skills/mem-search/

These paths are for Claude Code. For other tools, the command above puts it in the right place.

This skill should be used when the user asks to "search memory", "what do you remember about X", "check claude-mem", "mem search", "find past observations", "what did we do last session", or wants prior-session context about a project, decision, file, or task. Searches the user's Claude-Mem (cmem.ai) memory.

Claude-Mem Search

Search the user's persistent Claude-Mem memory on cmem.ai. Memory contains timestamped observations synthesized from past sessions across all their agents (Claude Code, the Claude app, Codex, and others).

How to search

Run the bundled CLI (no dependencies, uses the plugin's configured API key):

node "${CLAUDE_PLUGIN_ROOT}/scripts/cmem-hook.mjs" search "your query" --limit 20

Progressive search method

Follow claude-mem's Index β†’ Timeline β†’ Transcript discipline β€” cheap passes first, expensive detail only for confirmed hits:

  1. Index pass β€” run 1–3 broad keyword searches (project names, file names, error strings, feature names). Skim titles/summaries only.
  2. Narrow pass β€” re-search with the most specific terms found in step 1 (IDs, exact phrases) and a smaller --limit.
  3. Answer β€” synthesize from the observations returned. Quote timestamps when the user asks "when".

Do not dump raw search output at the user; extract the relevant observations and answer in plain language.

Diagnostics

If searches return nothing or error:

node "${CLAUDE_PLUGIN_ROOT}/scripts/cmem-hook.mjs" status

Report the status output plainly: a MISSING api key means the plugin needs the user's cmem.ai key added to its configuration; a 404 on /api/hooks/context just means the newer Pro endpoint isn't deployed β€” search still works via /api/mcp.

Notes

  • Some filters (date ranges, type) may be silently ignored by the cloud API until MCP parity ships β€” prefer keyword narrowing over filter flags.
  • Never write secrets into search queries; queries are sent to cmem.ai.

More from this repository10

πŸͺ
thedotmack-claude-memπŸͺMarketplace

Claude-Mem gives Claude Code a memory that stays after a session ends. It keeps that memory in a compressed, shorter form.

πŸ”Œ
claude-memπŸ”ŒPlugin

claude-mem gives Claude Code a memory that lasts between sessions. It records what Claude does while you work, saves short summaries, and shows that context automatically when you start a new session.

🎯
smart-explore🎯Skill

Lets your AI agent explore a codebase by looking at its outline first, such as function and class names, instead of reading whole files. This saves the agent's reading budget. It uses three companion tools to search code, show a file's structure, and open only the part you need.

🎯
make-plan🎯Skill

Helps your AI agent write a step-by-step plan before building a feature. It first checks the real documentation for what is available, then splits the work into phases. Each phase has a clear goal, examples to copy, checks to prove it works, and mistakes to avoid.

🎯
do🎯Skill

Carries out a step-by-step plan by handing each piece of work to separate helper agents. After each step it checks the result, reviews the code and saves the changes to git only when the checks pass.

🎯
timeline-report🎯Skill

Writes a story-style report of a project's whole development history, based on the notes that claude-mem has saved over time. It needs the claude-mem background service to be running.

🎯
claude-code-plugin-release🎯Skill

Automated semantic versioning and release workflow for Claude Code plugins, bumps package.json, marketplace.json, and plugin.json in lockstep, runs the build, tags the commit, creates a GitHub release, and generates changelog entries. Enforces 'nothing left uncommitted or unpushed' by running git status at the end.

🎯
knowledge-agent🎯Skill

Turns the notes claude-mem keeps about your past work into focused knowledge bases you can chat with. You pick notes by project, topic, file, or date, load them into a session, then ask questions about past decisions and fixes.

🎯
design-is🎯Skill

Reviews a design against Dieter Rams' ten principles of good design, scoring each one with evidence. It then recommends a new design, a refinement or a redesign, and writes a ready-to-use prompt for /make-plan.

🎯
learn-codebase🎯Skill

Tells your AI to read every source file in your project in full before starting work, so it deeply understands the code. It uses a lot of tokens up front to save effort later.