memloom-setup
Install and configure memloom end to end. Daemon, config, MCP registration, Claude Code capture and recall hooks, first import. Use when asked to set up memloom.
SKILL.mdskills/memloom-setup/SKILL.md
GitHubmemloom setup
Install memloom, a local-first memory engine, on this machine. The full runbook with expected output per step lives at https://docs.memloom.dev/guides/agent-setup; it is the source of truth if anything here is unclear.
Human gates
Do everything yourself except two things:
- Ask the human for
OPENROUTER_API_KEYwhen step 3 comes. Never print the key anywhere. If they decline, continue in offline mode and say recall quality is degraded. - Never run
memloom connect claude-codeor a non-dry-runmemloom importwithout the human naming the scope or approving the run.
Steps
- Check
node --versionis 20 or later. If not, stop and ask the human to upgrade. npm install -g memloom, thenmemloom init. This creates~/.memloomand starts the daemon onhttp://127.0.0.1:4319.- Ask for the API key. Add
OPENROUTER_API_KEY=...to~/.memloom/config.env, thenmemloom stopandmemloom initto restart. If anything was saved before the key was set, the daemon refuses to start: runmemloom stop,memloom reembed,memloom init. - Register MCP. Claude Code:
claude mcp add memloom -- npx -y @memloom/mcp. Other clients run the same command as a stdio server; configs are at https://docs.memloom.dev/mcp/setup. - Ask which projects to capture, then
memloom connect claude-code --project <name>(repeatable) or--allwith explicit approval. This installs session-end capture and prompt-time recall hooks; edits merge with existing hooks and a backup is written first. memloom import agent-memory --dry-run, show the human, run for real. Thenmemloom import sessions --dry-run, get approval (this one spends LLM calls), run.- Verify:
memloom save "memloom setup verified",memloom recall "setup verified"expecting the hit, onerecall_memorycall through MCP, thenmemloom statusexpecting daemon running, both hooks installed, and the chosen scope.
Common failures
command not foundafter install: Node older than 20, npm skipped the package.- 503 "store is locked": a psql/Drizzle client holds the single-connection lock; close it.
- Embedding mismatch on start:
memloom stop && memloom reembed, thenmemloom init. import sessionsrefuses offline: distillation needs the LLM; set the key first.