Claude Mem0 Project Memory

Claude Mem0项目内存插件

🧠 基于Mem0的Claude Code智能长期内存管理

  

特性

• ✅ 自动捕获：在编码会话期间自动捕获决策、模式和学习
• 🔍 语义搜索：使用自然语言从过去的工作中寻找相关背景
• 🔄 智能同步：用重要模式更新您的CLAUDE.md
• 🎯 项目范围：使用语义标记按项目组织内存
• 🧠 代理技能：克劳德在需要时会自动回忆起相关的记忆
• 🛠️ 显式控制：手动内存管理的Slash命令
• 🪝 基于钩子：通过SessionStart、SessionEnd和PostToolUse挂钩实现自动化工作流

安装

先决条件

1. Mem0帐户：注册地址： 成员.ai 获取API密钥
2. Node.js：必需 @mem0/mcp-server
3. jq：用于钩子中的JSON处理(brew install jq / apt install jq)

设置

1.克隆此存储库

git clone https://github.com/evgenygurin/claude-mem0-project-memory.git
cd claude-mem0-project-memory

2.使脚本可执行

chmod +x scripts/*.sh

3.在您的项目中安装

cd /path/to/your/project
mkdir -p .claude/plugins
cp -r /path/to/claude-mem0-project-memory .claude/plugins/

4.配置环境

添加到您的shell配置文件或 .env:

export MEM0_API_KEY="your-mem0-api-key"
export MEM0_USER_ID="your-user-id"  # optional, defaults to project name

5.在克劳德代码中启用

/settings plugins
# Enable claude-mem0-project-memory

用法

🤖 自动模式

启用后，插件会自动：

1. 初始化 会话开始时
2. 跟踪更改 编辑代码时（写入/编辑工具用法）
3. 回忆往事 当相关上下文存在时（通过代理技能）
4. 自动保存到Mem0 在会话结束时（SessionEnd钩子）

- 捕获带有更改计数的会话摘要 - 通过API直接存储到Mem0（无需手动干预） - 包括元数据：项目、时间戳、类型、更改计数

1. 通知 达到同步阈值时（5+次更改）

📝 手动命令

捕获内存

/mem0-capture We standardized error handling to always use Result pattern

搜索内存

/mem0-search error handling patterns
/mem0-search database migration decisions

同步到CLAUDE.md

/mem0-sync              # Sync all memories
/mem0-sync decisions    # Sync only decisions

反思会议

/mem0-reflect           # Analyze last 5 sessions
/mem0-reflect 10        # Analyze last 10 sessions

配置

编辑 .claude/plugins/claude-mem0-project-memory/config/memory-config.json:

{
  "auto_capture": true,                  // Enable hooks (tracking, notifications)
  "auto_add_to_mem0": true,              // Auto-save session summaries to Mem0
  "sync_to_claude_md": true,             // Auto-sync to CLAUDE.md
  "auto_load_context": false,            // Load memories at session start
  "reflection_threshold": 5,             // Changes before suggesting sync

  "skill_settings": {
    "auto_recall_enabled": true,         // Enable automatic memory recall
    "recall_threshold": 0.75,            // Minimum relevance for auto-recall
    "max_context_memories": 5            // Max memories to load per recall
  },

  "hook_settings": {
    "session_start_init": true,          // Initialize at session start
    "track_tool_usage": true,            // Track Write/Edit events
    "log_mem0_calls": false,             // Debug logging (verbose)
    "min_changes_for_capture": 3,        // Minimum edits before capture
    "capture_session_summary": true,     // Capture session summaries
    "capture_significant_changes": false // Capture individual changes (verbose)
  }
}

关键设置

• auto_add_to_mem0：何时 true，SessionEnd hook通过API自动将会话摘要添加到Mem0
• capture_session_summary：控制是否捕获会话摘要
• capture_significant_changes：（未来）捕获单个重大代码更改

建筑

┌───────────────────────────┐
│     Claude Code Agent      │
│   (with Sonnet 4.5)       │
└───────────┬────────────────┘
            │
            ├─── Skills (automatic)
            │    └── recall-project-memory
            │
            ├─── Commands (user-invoked)
            │    ├── /mem0-capture
            │    ├── /mem0-search
            │    ├── /mem0-sync
            │    └── /mem0-reflect
            │
            ├─── Hooks (event-driven)
            │    ├── SessionStart
            │    ├── SessionEnd
            │    ├── PostToolUse (Write|Edit)
            │    └── Stop
            │
            ↓
┌───────────────────────────┐
│      MCP Server              │
│    (@mem0/mcp-server)       │
└───────────┬────────────────┘
            │
            ↓
┌───────────────────────────┐
│   Mem0 API (Cloud/Self)    │
│  Long-term Semantic Memory │
└───────────────────────────┘

运作原理

1.🎯 捕捉

自动:

• SessionEnd钩子分析成绩单
• 提取决策、模式、错误、解决方案
• 将重要见解存储到Mem0

手册:

• 使用 /mem0-capture 显式保存重要上下文

2.💾 商店

存储在以下位置的记忆：

• 语义嵌入 用于相似性搜索
• 项目范围 （user_id=项目名称）
• 元数据：类型、标签、时间戳、来源
• 内存类型：决策、模式、约束、学习

3.🔍 检索

自动（代理技能）:

• 克劳德检测到任务何时可能从记忆中受益
• 自动搜索Mem0
• 应用相关模式/约束
• 与过去的决策保持一致

手册:

• /mem0-search 用于显式搜索
• 返回分组、相关性评分的结果

4.🔄 同步

已同步到CLAUDE.md的重要模式：

• 自动生成的部分会定期更新
• 保留手册指南
• 基于阈值的通知
• 可通过内存ID进行跟踪

项目内存结构

在你的 CLAUDE.md:

## Project Memory

### Manual Guidelines

[Your hand-written rules - never auto-modified]

### Auto-Discovered Patterns

#### Architecture Decisions
- **[2025-12-14]** Using Result for error handling [[mem0:abc123]]
- **[2025-12-10]** PostgreSQL chosen for JSONB support [[mem0:def456]]

#### Code Patterns  
- **[2025-12-13]** API routes follow /api/v1/{resource} structure [[mem0:ghi789]]
- **[2025-12-11]** Builder pattern for complex configs [[mem0:jkl012]]

#### Constraints
- **[2025-12-12]** JWT tokens: 15min expiry (security requirement) [[mem0:mno345]]

#### Key Learnings
- **[2025-12-09]** Database indexes critical for query performance [[mem0:pqr678]]

路线图

• \[ \] v0.3：LLM驱动的成绩单摘要（与简单启发式）
• \[ \] v0.4：跨项目共享团队记忆
• \[ \] v0.5：内存分析仪表板
• \[ \] v0.6：与Linear/GitHub集成问题
• \[ \] v0.7：智能内存修剪和归档
• \[ \] v0.8：CLAUDE.md更新的冲突解决
• \[ \] v0.9：内存版本控制和差异可视化
• \[ \] v1.0：生产准备就绪，经过全面测试

贡献

欢迎投稿！拜托：

1. 分叉回购
2. 创建特征分支(git checkout -b feature/amazing-feature)
3. 遵循官方的Claude Code插件规范
4. 如果适用，添加测试
5. 更新文档
6. 提交带有清晰描述的PR

许可证

MIT许可证-请参阅 许可证 文件

支持

• 问题:
• 文档: 设置.md, 更改日志.md
• 克劳德代码: docs.code.claude.com
• Mem0: 医学博士

学分

内置：

• 克劳德代码 通过Anthropic
• Mem0 长期语义记忆
• 模型上下文协议（MCP）

______________________________________________________________________

制作❤️ 通过 @evgenygurin