Lesson 4: claude-mem Plugin Core Features and Positioning
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:
- Hooks (Automation):
- Triggered automatically at key points such as session start, post-tool usage, and session end to capture and distill information.
- MCP Tools (On-demand Retrieval):
- Provides tools like
searchandtimelinethat allow the LLM to query historical experiences when needed.
- Provides tools like
- Skills (Advanced Skillset):
- Offers 10 specific skills like
mem-search,learn-codebase, andmake-planto enhance the LLM's processing power.
- Offers 10 specific skills like
- 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.