thedotmack/claude-mem

AI 总结

• 项目定位为 Claude Code 的持久化记忆压缩系统，自动记录工具使用、生成语义摘要并在新会话注入上下文。
• 提供分层检索机制（search/timeline/get_observations）与 mem-search 技能，强调约 10 倍 token 成本节省。
• 架构包含生命周期 Hook、Bun 管理的 Worker 服务（含 Web UI 与 API）、SQLite + FTS5 及 Chroma 向量检索。
• 支持隐私控制（private 标签过滤）、上下文注入配置、引用观测 ID 等工程化能力。
• 仓库展示多语言文档、Node>=18、AGPL-3.0 许可与 v6.5.0 版本信息，适合开发者直接集成与扩展。

内容摘录

<p align="center">
 Official $CMEM Links: 
 <a href="https://bags.fm/2TsmuYUrsctE57VLckZBYEEzdokUF8j8e1GavekWBAGS">Bags.fm</a> •
 <a href="https://jup.ag/tokens/2TsmuYUrsctE57VLckZBYEEzdokUF8j8e1GavekWBAGS">Jupiter</a> •
 <a href="https://photon-sol.tinyastro.io/en/lp/6MzFAkWnac6GSK1EdFX93dZeukGfzrFq4UHWarhGSQyd">Photon</a> •
 <a href="https://dexscreener.com/solana/6mzfakwnac6gsk1edfx93dzeukgfzrfq4uhwarhgsqyd">DEXScreener</a>
</p>

<p align="center">Official CA: 2TsmuYUrsctE57VLckZBYEEzdokUF8j8e1GavekWBAGS (on Solana)</p>

<h1 align="center">
 <br>
 <a href="https://github.com/thedotmack/claude-mem">
 <picture>
 <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/claude-mem-logo-for-dark-mode.webp">
 <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/claude-mem-logo-for-light-mode.webp">
 <img src="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/claude-mem-logo-for-light-mode.webp" alt="Claude-Mem" width="400">
 </picture>
 </a>
 <br>
</h1>

<p align="center">
 <a href="docs/i18n/README.zh.md">🇨🇳 中文</a> •
 <a href="docs/i18n/README.zh-tw.md">🇹🇼 繁體中文</a> •
 <a href="docs/i18n/README.ja.md">🇯🇵 日本語</a> •
 <a href="docs/i18n/README.pt.md">🇵🇹 Português</a> •
 <a href="docs/i18n/README.pt-br.md">🇧🇷 Português</a> •
 <a href="docs/i18n/README.ko.md">🇰🇷 한국어</a> •
 <a href="docs/i18n/README.es.md">🇪🇸 Español</a> •
 <a href="docs/i18n/README.de.md">🇩🇪 Deutsch</a> •
 <a href="docs/i18n/README.fr.md">🇫🇷 Français</a> •
 <a href="docs/i18n/README.he.md">🇮🇱 עברית</a> •
 <a href="docs/i18n/README.ar.md">🇸🇦 العربية</a> •
 <a href="docs/i18n/README.ru.md">🇷🇺 Русский</a> •
 <a href="docs/i18n/README.pl.md">🇵🇱 Polski</a> •
 <a href="docs/i18n/README.cs.md">🇨🇿 Čeština</a> •
 <a href="docs/i18n/README.nl.md">🇳🇱 Nederlands</a> •
 <a href="docs/i18n/README.tr.md">🇹🇷 Türkçe</a> •
 <a href="docs/i18n/README.uk.md">🇺🇦 Українська</a> •
 <a href="docs/i18n/README.vi.md">🇻🇳 Tiếng Việt</a> •
 <a href="docs/i18n/README.tl.md">🇵🇭 Tagalog</a> •
 <a href="docs/i18n/README.id.md">🇮🇩 Indonesia</a> •
 <a href="docs/i18n/README.th.md">🇹🇭 ไทย</a> •
 <a href="docs/i18n/README.hi.md">🇮🇳 हिन्दी</a> •
 <a href="docs/i18n/README.bn.md">🇧🇩 বাংলা</a> •
 <a href="docs/i18n/README.ur.md">🇵🇰 اردو</a> •
 <a href="docs/i18n/README.ro.md">🇷🇴 Română</a> •
 <a href="docs/i18n/README.sv.md">🇸🇪 Svenska</a> •
 <a href="docs/i18n/README.it.md">🇮🇹 Italiano</a> •
 <a href="docs/i18n/README.el.md">🇬🇷 Ελληνικά</a> •
 <a href="docs/i18n/README.hu.md">🇭🇺 Magyar</a> •
 <a href="docs/i18n/README.fi.md">🇫🇮 Suomi</a> •
 <a href="docs/i18n/README.da.md">🇩🇰 Dansk</a> •
 <a href="docs/i18n/README.no.md">🇳🇴 Norsk</a>
</p>

<h4 align="center">Persistent memory compression system built for <a href="https://claude.com/claude-code" target="_blank">Claude Code</a>.</h4>

<p align="center">
 <a href="LICENSE">
 <img src="https://img.shields.io/badge/License-AGPL%203.0-blue.svg" alt="License">
 </a>
 <a href="package.json">
 <img src="https://img.shields.io/badge/version-6.5.0-green.svg" alt="Version">
 </a>
 <a href="package.json">
 <img src="https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg" alt="Node">
 </a>
 <a href="https://github.com/thedotmack/awesome-claude-code">
 <img src="https://awesome.re/mentioned-badge.svg" alt="Mentioned in Awesome Claude Code">
 </a>
</p>

<p align="center">
 <a href="https://trendshift.io/repositories/15496" target="_blank">
 <picture>
 <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/trendshift-badge-dark.svg">
 <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/trendshift-badge.svg">
 <img src="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/trendshift-badge.svg" alt="thedotmack/claude-mem | Trendshift" width="250" height="55"/>
 </picture>
 </a>
</p>

<br>

<p align="center">
 <a href="https://github.com/thedotmack/claude-mem">
 <picture>
 <img src="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/cm-preview.gif" alt="Claude-Mem Preview" width="800">
 </picture>
 </a>
</p>

<p align="center">
 <a href="#quick-start">Quick Start</a> •
 <a href="#how-it-works">How It Works</a> •
 <a href="#mcp-search-tools">Search Tools</a> •
 <a href="#documentation">Documentation</a> •
 <a href="#configuration">Configuration</a> •
 <a href="#troubleshooting">Troubleshooting</a> •
 <a href="#license">License</a>
</p>

<p align="center">
 Claude-Mem seamlessly preserves context across sessions by automatically capturing tool usage observations, generating semantic summaries, and making them available to future sessions. This enables Claude to maintain continuity of knowledge about projects even after sessions end or reconnect.
</p>

---
Quick Start

Start a new Claude Code session in the terminal and enter the following commands:

Restart Claude Code. Context from previous sessions will automatically appear in new sessions.
**Note:** Claude-Mem is also published on npm, but npm install -g claude-mem installs the **SDK/library only** — it does not register the plugin hooks or set up the worker service. To use Claude-Mem as a plugin, always install via the /plugin commands above.
🦞 OpenClaw Gateway

Install claude-mem as a persistent memory plugin on OpenClaw gateways with a single command:

The installer handles dependencies, plugin setup, AI provider configuration, worker startup, and optional real-time observation feeds to Telegram, Discord, Slack, and more. See the OpenClaw Integration Guide for details.

**Key Features:**
🧠 **Persistent Memory** - Context survives across sessions
📊 **Progressive Disclosure** - Layered memory retrieval with token cost visibility
🔍 **Skill-Based Search** - Query your project history with mem-search skill
🖥️ **Web Viewer UI** - Re…