Lesson 4: claude-mem Plugin Core Features and Positioning

⏱ Est. reading time: 3 min Updated on 5/7/2026

4.1 What is claude-mem?

claude-mem is a Claude Code plugin developed by community member thedotmack. Its core purpose is to automatically capture session interactions and distill them into a searchable global knowledge base.

Unlike the built-in auto memory, claude-mem focuses on "cross-project retrieval" and "automatic full capture." It acts like an "external hard drive" with semantic search capabilities, specifically designed for AI agents.

4.2 Core Functional Modules

claude-mem is composed of four main dimensions:

  1. Hooks (Automation):
    • Triggered automatically at key points such as session start, post-tool usage, and session end to capture and distill information.
  2. MCP Tools (On-demand Retrieval):
    • Provides tools like search and timeline that allow the LLM to query historical experiences when needed.
  3. Skills (Advanced Skillset):
    • Offers 10 specific skills like mem-search, learn-codebase, and make-plan to enhance the LLM's processing power.
  4. Persistent Storage:
    • Uses SQLite for metadata and full-text indexing.
    • Uses Chroma (a vector database) for semantic retrieval.

4.3 Typed Records (Observations)

claude-mem categorizes captured information into different types of "Observations":

Type Meaning
bugfix Records a bug fix process and solution.
discovery Facts or constraints discovered about the project.
decision Architectural or functional decisions made.
feature Newly added features.
refactor Structural adjustments to the code.

Each record includes a summary, project identifier, timestamp, and a pointer to the original session file, making it highly traceable for future sessions.