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".
32 stars
0 votes
0 copies
1 view
Added May 26, 2026
developmentpythongoshellbash
Works with
claude code
cli
mcp
Security analysis
A92/100
mediumInstalls packages at runtime which could introduce malicious dependencies
Installs into .claude/skills of the current project.
Are you the author of Memem Doctor?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/tt-wang-memem-doctor)
---
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:
```bash
PYTHONPATH="${CLAUDE_PLUGIN_ROOT}" python3 -m memem.server --doctor
```
Display 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.
