mem-search

thedotmack/claude-mem · cowork/skills/mem-search/SKILL.md

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.

Data & AINo license★ 100792⑂ 8830commit fef3402

Install skillView source on GitHub

What this skill does

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

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:

Index pass — run 1–3 broad keyword searches (project names, file names, error strings, feature names). Skim titles/summaries only.
Narrow pass — re-search with the most specific terms found in step 1 (IDs, exact phrases) and a smaller --limit.
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.

Installation

Copy a source-pinned command for your client. You run it yourself.

Destination: .claude/skills/mem-search · 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/cowork/skills/mem-search" ".claude/skills/"
rm -rf .skillboard-tmp

Review the source before running. This copies files into your project; it is not a one-click install and does not verify runtime safety.

New here? Step-by-step setup – from installing the agent to using the skill

Operating systemAgentI already use Claude Code

1
Install Git
Install Git with your package manager (Debian/Ubuntu shown; use dnf/pacman on others). Official download.
```
sudo apt update && sudo apt install -y git
```
2
Install Claude Code
Requires Node.js 18+. Install the CLI globally: Official docs. (command-line tool)
```
npm install -g @anthropic-ai/claude-code
```

Get the skill, pinned to its exact version

Open a terminal and run these steps (they clone the source, check out the exact commit, and copy the skill into place):

# 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/cowork/skills/mem-search" ".claude/skills/"
rm -rf .skillboard-tmp

Destination: .claude/skills/mem-search

4
Use it in Claude Code
Open Claude Code in your project. It reads skills from the folder above, so mem-search is now available. Always review the source before using it – static checks cannot prove runtime safety.

Security & Audits

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.

mem-search

thedotmack/claude-mem · cowork/skills/mem-search/SKILL.md

Data & AINo license★ 100792⑂ 8830commit fef3402

Install skillView source on GitHub

What this skill does

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

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:

Index pass — run 1–3 broad keyword searches (project names, file names, error strings, feature names). Skim titles/summaries only.
Narrow pass — re-search with the most specific terms found in step 1 (IDs, exact phrases) and a smaller --limit.
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

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.

Installation

Copy a source-pinned command for your client. You run it yourself.

Destination: .claude/skills/mem-search · 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/cowork/skills/mem-search" ".claude/skills/"
rm -rf .skillboard-tmp

Review the source before running. This copies files into your project; it is not a one-click install and does not verify runtime safety.

New here? Step-by-step setup – from installing the agent to using the skill

Operating systemAgentI already use Claude Code

1
Install Git
Install Git with your package manager (Debian/Ubuntu shown; use dnf/pacman on others). Official download.
```
sudo apt update && sudo apt install -y git
```
2
Install Claude Code
Requires Node.js 18+. Install the CLI globally: Official docs. (command-line tool)
```
npm install -g @anthropic-ai/claude-code
```

Get the skill, pinned to its exact version

Open a terminal and run these steps (they clone the source, check out the exact commit, and copy the skill into place):

# 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/cowork/skills/mem-search" ".claude/skills/"
rm -rf .skillboard-tmp

Destination: .claude/skills/mem-search

4
Use it in Claude Code
Open Claude Code in your project. It reads skills from the folder above, so mem-search is now available. Always review the source before using it – static checks cannot prove runtime safety.

Security & Audits

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.

mem-search

What this skill does

Claude-Mem Search (Cowork)

How to search

Progressive search method

Diagnostics

Notes

Installation

Install Git

Install Claude Code

Get the skill, pinned to its exact version

Use it in Claude Code

Security & Audits

mem-search

What this skill does

Claude-Mem Search (Cowork)

How to search

Progressive search method

Diagnostics

Notes

Installation

Install Git

Install Claude Code

Get the skill, pinned to its exact version

Use it in Claude Code

Security & Audits