longmem CLAUDE.md

longmem

MCP plugin that stores problem/solution pairs in a local vector DB (LanceDB) and suggests cached solutions across projects using embedding similarity search.

Auto-memory workflow — follow every time

Step 1 — search before solving

Before reasoning about any bug, error, or implementation question, call:

search_similar(
  problem="<clear description of what is broken or needed>",
  category="<best matching category>",
  tags=["<library>", "<tool>", "<error type>"],
  language="<language if relevant>"
)

• Similarity ≥ 85%: present the cached solution first. Check edge_cases — if any apply, say so upfront.
• Similarity < 85%: solve normally, then go to Step 2.

Step 2 — save after confirmed solve

Wait until the conversation reaches a natural end (user confirms it works, no more follow-ups). Then synthesize and call:

confirm_solution(
  solution="<synthesized, reusable answer — see format below>",
  project="longmem"
)

Problem description, category, tags, and language are filled in automatically from the Step 1 call.

How to write solution for maximum reuse:

• State the general pattern or principle first
• Then give the specific detail from this session as an example
• Bad: "Port 4181 is used by the auth proxy for Paperless"
• Good: "Port 418x is typically an OAuth2 auth proxy frontend. Default is 4180. Use 4181+ when 4180 is already taken by another auth proxy in the same stack. Example: Sifonia on 4180, Paperless-NGX auth proxy on 4181."

If you did not call search_similar first (skipped Step 1), fall back to:

save_solution(
  problem="<clear, reusable description — not tied to this repo>",
  solution="<synthesized answer as above>",
  category="<category>",
  project="longmem",
  tags=["<library>", "<tool>", "<error type>"],
  language="<language>"
)

Step 3 — fix or enrich after saving

If entry_id is in context (same conversation as the save):

• Correction (wrong name/term): correct_solution(entry_id=..., find=..., replace=...)
• New facts/context: enrich_solution(entry_id=..., context=...)
• Failure/exception: add_edge_case(entry_id=..., edge_case=...)