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 --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 willuv sync) - ~/.memem not writable → set
MEMEM_DIR=/writable/pathenv var in their shell profile - vault not writable → set
MEMEM_OBSIDIAN_VAULT=/writable/pathenv 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.