Skill
memem-mine-history
Mine ALL existing Claude Code sessions, including history from before memem was installed.
Development
Skill
/memem-doctor
Run a preflight health check on memem — Python version, mcp dep, claude CLI, vault writability, capabilities. Use when the user reports memem misbehaving, has just installed the plugin, or asks "why isn't this working".
Install
$ npx -y skills add TT-Wang/memem --skill memem-doctor --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
- Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
- You can call itInvoke it directly when you want it.
- Slash command
/memem-doctor
Context preview
The summary Claude sees to decide when to auto-load this skill.
Run a preflight health check on memem — Python version, mcp dep, claude CLI, vault writability, capabilities. Use when the user reports memem misbehaving, has just installed the plugin, or asks "why isn't this working".
SKILL.md
memem-doctor.SKILL.mdname: memem-doctor
description: Run a preflight health check on memem — Python version, mcp dep, claude CLI, vault writability, capabilities. Use when the user reports memem misbehaving, has just installed the plugin, or asks "why isn't this working".
allowed-tools: [Bash]
Run `bash "${CLAUDE_PLUGIN_ROOT}/bootstrap.sh" --help` to confirm the bootstrap shim is present, then run the doctor:
PYTHONPATH="${CLAUDE_PLUGIN_ROOT}" python3 -m memem.server --doctorDisplay the full output verbatim. If the result says **FAILING**, the user must fix the listed blockers before memem will work — walk them through each one:
- **mcp package missing** → `pip install mcp` (or re-run bootstrap.sh which will `uv sync`)
- **~/.memem not writable** → set `MEMEM_DIR=/writable/path` env var in their shell profile
- **vault not writable** → set `MEMEM_OBSIDIAN_VAULT=/writable/path` env var
If the result says **DEGRADED**, the system works but Haiku-powered context assembly and smart-recall are disabled because the `claude` CLI isn't on PATH. memem falls back to FTS-only recall, which is still useful — just less smart. Tell the user how to fix it (install Claude Code CLI, ensure it's on PATH) but don't block them on it.
If the result says **HEALTHY**, tell the user everything looks good and suggest running `/memem-status` to see memory counts, or just continue their conversation — memem runs automatically in the background.
Read more
name: memem-doctor description: Run a preflight health check on memem — Python version, mcp dep, claude CLI, vault writability, capabilities. Use when the user reports memem misbehaving, has just installed the plugin, or asks "why isn't this working". allowed-tools: [Bash]
Run `bash "${CLAUDE_PLUGIN_ROOT}/bootstrap.sh" --help` to confirm the bootstrap shim is present, then run the doctor:
PYTHONPATH="${CLAUDE_PLUGIN_ROOT}" python3 -m memem.server --doctorDisplay the full output verbatim. If the result says **FAILING**, the user must fix the listed blockers before memem will work — walk them through each one:
- **mcp package missing** → `pip install mcp` (or re-run bootstrap.sh which will `uv sync`)
- **~/.memem not writable** → set `MEMEM_DIR=/writable/path` env var in their shell profile
- **vault not writable** → set `MEMEM_OBSIDIAN_VAULT=/writable/path` env var
If the result says **DEGRADED**, the system works but Haiku-powered context assembly and smart-recall are disabled because the `claude` CLI isn't on PATH. memem falls back to FTS-only recall, which is still useful — just less smart. Tell the user how to fix it (install Claude Code CLI, ensure it's on PATH) but don't block them on it.
If the result says **HEALTHY**, tell the user everything looks good and suggest running `/memem-status` to see memory counts, or just continue their conversation — memem runs automatically in the background.
Ships withmemem
Persistent, self-evolving memory for Claude Code. Stop re-explaining your project every session. <!-- The Glama badge URL below intentionally uses the legacy cortex-plugin slug.
Get the whole plugin
Other skills on memem.
Skill
memem-mine
Opt in to memem's event-triggered mining. New sessions are mined automatically via the Stop hook.
Skill
memem-status
Show detailed memem memory system status — memory count, projects, search DB, miner health.
Skill
memem-welcome
Re-show the full memem welcome screen regardless of whether the user has seen it before. Use when the user wants to see the intro, tutorial, or welcome again.