‏Claude-Mem: حافظهٔ ماندگار برای Claude Code

Claude-Mem یه پلاگین متن‌باز با لایسنس Apache 2.0 هست که برای Claude Code ساخته شده. مشکلی که حل می‌کنه ساده‌ست: وقتی یه سشن تموم می‌شه، ایجنت همه‌چیز رو درباره پروژه فراموش می‌کنه. Claude-Mem کارهایی که ایجنت با ابزارهاش انجام می‌ده رو ثبت می‌کنه، ازشون خلاصهٔ معنایی می‌سازه و تو سشن بعدی خودکار به کانتکست اضافه‌شون می‌کنه.

این کار با lifecycle hookها انجام می‌شه، یعنی نقطه‌هایی که Claude Code تو چرخهٔ کارش یه دستور بیرونی رو صدا می‌زنه، مثل SessionStart، PostToolUse و SessionEnd. داده‌ها تو یه دیتابیس SQLite ذخیره می‌شن و یه Worker Service محلی که با Bun اجرا می‌شه، یه API و یه رابط وب برای دیدنشون می‌ده. برای جستجو هم از Chroma استفاده می‌کنه که جستجوی معنایی و کلیدواژه‌ای رو با هم ترکیب می‌کنه.

نکتهٔ جالبش روش جستجوی سه‌مرحله‌ایه که اسمش رو progressive disclosure گذاشتن، یعنی اطلاعات لایه‌لایه و فقط به اندازهٔ لازم داده می‌شه. اول search یه فهرست فشرده با ID برمی‌گردونه (حدود ۵۰ تا ۱۰۰ توکن برای هر نتیجه). بعد timeline نشون می‌ده دور و بر یه مورد چی اتفاق افتاده. آخر سر get_observations فقط جزئیات IDهای انتخاب‌شده رو میاره (حدود ۵۰۰ تا ۱۰۰۰ توکن برای هر نتیجه). به گفتهٔ سازنده، این فیلتر کردن قبل از گرفتن جزئیات حدود ۱۰ برابر توکن کمتر مصرف می‌کنه.

search(query="authentication bug", type="bugfix", limit=10)

get_observations(ids=[123, 456])

نصبش با npx claude-mem install انجام می‌شه و غیر از Claude Code، برای OpenCode، T3 Code، Antigravity CLI، Pi و چند ابزار دیگه هم نسخه داره. تو README اومده که نصب‌کننده بعد از راه‌اندازی ازت می‌خواد وارد حساب claude-mem بشی و یه دورهٔ آزمایشی ۳۰ روزه برای سرویس میزبانی‌شده‌شون فعال می‌شه. اگه نخوای، می‌تونی با فلگ --provider یا CLAUDE_MEM_ONLINE_OPTIN=false این مرحله رو رد کنی. یه نکته هم مهمه: npm install -g claude-mem فقط کتابخونه رو نصب می‌کنه و hookها رو راه نمیندازه.

برای حریم خصوصی می‌تونی بخش‌های حساس رو بین تگ‌های private بذاری تا ذخیره نشن. حالت و زبان خلاصه‌ها هم با تنظیم CLAUDE_MEM_MODE عوض می‌شه، مثلاً code--zh برای چینی.

نکات کلیدی:

• Claude-Mem با لایسنس Apache 2.0 منتشر شده و به Node.js 20 یا بالاتر نیاز داره.
• داده‌ها تو SQLite ذخیره می‌شن و جستجو با Chroma به‌صورت ترکیبی معنایی و کلیدواژه‌ای انجام می‌شه.
• سه ابزار MCP اصلی داره: search، timeline و get_observations.
• به گفتهٔ سازنده، جستجوی لایه‌لایه حدود ۱۰ برابر توکن کمتر مصرف می‌کنه.
• تنظیماتش تو فایل ~/.claude-mem/settings.json نگه داشته می‌شه.