Agent skill

Claude-Mem Search

by thedotmack in thedotmack/claude-mem

Searches the user's persistent cross-session memory for timestamped observations synthesized from past agent sessions on cmem.ai.

Apache-2.0Auto-check passedAgent Workflows

Install Claude-Mem Search

skills CLI
$ npx skills add thedotmack/claude-mem --skill mem-search -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install thedotmack/claude-mem mem-search --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/thedotmack/claude-mem.git skills-src && mkdir -p .claude/skills && cp -r skills-src/cowork/skills/mem-search .claude/skills/mem-search && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
mem-search
GitHub stars
99k
Token cost
~511 tokens
SKILL.md length
213 words
Files
1
Skills in repo
26
Repo updated
First seen
Licence
Apache-2.0

At a glance

Searches the user's persistent cross-session memory for timestamped observations synthesized from past agent sessions on cmem.ai.

  • Works in 3 steps: Index pass — run 1–3 broad keyword… → Narrow pass — re-search with the most… → Answer — synthesize from the…
  • Recalling what was done in a previous session on this project
  • SKILL.md covers How to search, Progressive search method, Diagnostics and Notes
  • Calls node

What it does

This skill runs a bundled, dependency-free CLI script against a configured API key, following an index-then-narrow discipline: one to three broad keyword searches first, skimming only titles and summaries, then a narrower re-search with the most specific terms or exact phrases found, before synthesizing an answer rather than dumping raw results at the user.

It reports a missing API key, or a 404 on a newer endpoint, in plain language rather than as a bare error, since search still works through an older endpoint either way, and it warns against ever putting secrets into a search query since queries are sent to the remote service.

When your agent uses it

  • Recalling what was done in a previous session on this project
  • Searching past observations for a decision, file, or task
  • Checking the status of the memory connection

Example prompts

  • “What did we decide about the auth flow last session?”
  • “Search my memory for anything about the pricing page redesign.”
  • “Check my memory connection status, my searches are returning nothing.”

Requirements

  • A cmem.ai API key configured for the plugin

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Index pass — run 1–3 broad keyword searches (project names, file names,
  2. Narrow pass — re-search with the most specific terms found in step 1
  3. Answer — synthesize from the observations returned. Quote timestamps

What it can do on your machine

Read from SKILL.md and the folder at commit fa8ab09. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • node

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Claude-Mem Search loads about 511 tokens when it runs. Until then it costs about 80 tokens; SKILL.md has 213 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~80
When it runs · the whole SKILL.md, loaded when a task matches
~511

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from thedotmack/claude-mem at commit fa8ab09, republished under its Apache-2.0 licence (© thedotmack). 213 words, ~511 tokens.

Download SKILL.mdSave it as .claude/skills/mem-search/SKILL.md (or your agent's skills folder).
name
mem-search
description
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.
metadata.version
0.1.0

Claude-Mem Search (Cowork)

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, Cowork, Codex, and others).

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

bash
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:

bash
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.

© thedotmack, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in cowork/skills/mem-search of thedotmack/claude-mem.

Open the folder on GitHubat commit fa8ab09

Compare with similar skills

Claude-Mem Search next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Claude-Mem Search compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Claude-Mem Search this skillthedotmack/claude-mem99k—~511Automated safety check: PassApache-2.0
Neat-Freak Knowledge CloseoutKKKKhazix/khazix-skills21k—~1.9kAutomated safety check: PassMIT
Beads Task Memorygastownhall/beads28k—~1.2kAutomated safety check: PassMIT
Reflect on Session Learningscursor/plugins11k5 repos~1.2kAutomated safety check: PassNone
MemPalace Memory SearchMemPalace/mempalace59k—~1.4kAutomated safety check: PassMIT
Compound Learning WriterEveryInc/compound-engineering-plugin25k—~2kAutomated safety check: PassMIT

Similar skills

  • Neat-Freak Knowledge Closeout

    KKKKhazix/khazix-skills

    Brings project docs, agent rule files, authorized memory and leftover workspace files back in line with what the code and runtime actually do at the end of a work session.

    21k GitHub stars~1.9k tokensUpdated 9 days ago
    Agent WorkflowsAuto-check passed
  • Beads Task Memory

    gastownhall/beads

    Tracks multi-session work with dependencies in the bd issue tracker so the agent can find ready tasks and recover its context after conversation compaction.

    28k GitHub stars~1.2k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Official

    Starts three parallel reviewer subagents over the current conversation transcript, then turns their findings into concrete edits to existing skills.

    11k GitHub starsUsed in 5 repos~1.2k tokens
    Agent WorkflowsAuto-check passed
  • MemPalace Memory Search

    MemPalace/mempalace

    Mines project files and conversation exports into a local, searchable memory palace and recalls past work by semantic search through the mempalace CLI.

    59k GitHub stars~1.4k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Compound Learning Writer

    EveryInc/compound-engineering-plugin

    Records one solved and verified problem as a durable learning in the repository, but only when the reasoning is not already clear from the final code, tests or docs.

    25k GitHub stars~2k tokensUpdated 2 days ago
    Agent WorkflowsAuto-check passed
  • Searches past Claude Code, Codex and Cursor sessions and summarizes what was worked on, tried or decided, using extraction scripts instead of reading raw logs.

    24k GitHub stars~3.1k tokensUpdated yesterday
    Agent WorkflowsAuto-check passed

More from thedotmack/claude-mem

All 26 skills in this repo
  • Walks you through creating, installing and verifying a custom claude-mem mode, including note types, tags and optional Telegram alerts for chosen memories.

    99k GitHub stars~2.4k tokensUpdated yesterday
    Auto-check passed
  • Pull Request Babysitter

    thedotmack/claude-mem

    Keeps watching a pull request, fixing real review and CI problems and resolving stale threads, until it is clean and ready to merge.

    99k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Claude-Mem Install for Grok Bot

    thedotmack/claude-mem

    Use this when setting up claude-mem on Grok Bot: local worker plus CMEM Pro observer (default), optional host-login observer, or remote cmem.ai. No Cursor…

    99k GitHub stars~440 tokensUpdated yesterday
    Auto-check passed
  • Claude-Mem Cloud Sync

    thedotmack/claude-mem

    Checks claude-mem cloud sync status and guides you through connecting a cmem.ai Pro account without the sync token ever passing through the chat.

    99k GitHub stars~1k tokensUpdated yesterday
    Auto-check: notes
  • Audits a design against Dieter Rams' ten principles of good design, scores each with evidence, and hands off a make-plan prompt for a new, refined or redesigned outcome.

    99k GitHub stars~4.6k tokensUpdated yesterday
    Auto-check passed
  • Session Handoff Document

    thedotmack/claude-mem

    Writes a HANDOFF.md capturing goal, state, files, failed attempts and next steps so a fresh agent session can continue exactly where this one stopped.

    99k GitHub stars~1.4k tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Claude-Mem Search

What does Claude-Mem Search do?

Searches the user's persistent cross-session memory for timestamped observations synthesized from past agent sessions on cmem.ai. This skill runs a bundled, dependency-free CLI script against a configured API key, following an index-then-narrow discipline: one to three broad keyword searches first, skimming only titles and summaries, then a narrower re-search with the most specific terms or exact phrases found, before synthesizing an answer rather than dumping raw results at the user.

When should I use Claude-Mem Search?

Claude-Mem Search fits situations like: recalling what was done in a previous session on this project; searching past observations for a decision, file, or task; checking the status of the memory connection.

How do I install Claude-Mem Search in Claude Code?

Run `npx skills add thedotmack/claude-mem --skill mem-search -a claude-code`. Or copy the skill folder (cowork/skills/mem-search in thedotmack/claude-mem) into .claude/skills/mem-search in your project. Claude Code loads it when a task matches its description.

How do I install Claude-Mem Search in Codex?

Run `npx skills add thedotmack/claude-mem --skill mem-search -a codex`. Or copy the skill folder (cowork/skills/mem-search in thedotmack/claude-mem) into .agents/skills/mem-search in your project. Codex loads it when a task matches its description.

Can I use Claude-Mem Search in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add thedotmack/claude-mem --skill mem-search -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/mem-search, .gemini/skills/mem-search, .github/skills/mem-search and .opencode/skills/mem-search in your project.

What does Claude-Mem Search need to run?

Going by SKILL.md and its folder, Claude-Mem Search needs the command-line tools its instructions call (node). Our summary lists: A cmem.ai API key configured for the plugin.

Does Claude-Mem Search access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Claude-Mem Search safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Claude-Mem Search use?

Claude-Mem Search is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Claude-Mem Search use?

About 511 tokens (SKILL.md is roughly 2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Claude-Mem Search?

Skills that share tags, products or a category with Claude-Mem Search: Neat-Freak Knowledge Closeout (KKKKhazix/khazix-skills, 21k stars), Beads Task Memory (gastownhall/beads, 28k stars), Reflect on Session Learnings (cursor/plugins, 11k stars) and MemPalace Memory Search (MemPalace/mempalace, 59k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Claude-Mem Search?

thedotmack (a GitHub user) maintains it in thedotmack/claude-mem, which has 99,047 GitHub stars. The repository holds 26 skills in this directory. The repository was last updated on October 9, 2026.

Source: thedotmack/claude-mem on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.