Claude-Mem: ذاكرة دائمة لـ Claude Code وأي AI agent — 96 ألف نجمة

🔗 رابط المشروع على GitHub: https://github.com/thedotmack/claude-mem

🌐 الموقع الرسمي: claude-mem.ai

📘 التوثيق: docs.claude-mem.ai

---

أكبر مشكلة في AI coding agents إنهم بينسوا. كل جلسة Claude Code جديدة بتبدأ من الصفر: نفس الأسئلة، نفس التوضيحات، نفس “خليني أقرأ المشروع الأول”. ده بيحرق تokens وبيضيّع وقت.

Claude-Mem من Alex Newman (@thedotmack) هو الحل الأكتر نضجاً للمشكلة دي. الـ repo وصل 96.7 ألف نجمة و8.5 ألف fork — أرقام نادرة لمشروع ذاكرة. مرخّص Apache 2.0، ومدعوم من Vercel OSS Program و SerpApi و Greptile.

الفكرة في جملة

Claude-Mem بيسجّل كل حاجة الـ agent بيعملها خلال الجلسة (أدوات، قرارات، bug fixes)، بيضغطها بـ AI لـ semantic summaries، وبيحقنها في الجلسات القادمة تلقائياً بدون أي تدخل منك.

النتيجة: Claude يفتكر مشروعك عبر الأيام والأسابيع.

الـ Harnesses المدعومة — 8+ أدوات

• Claude Code — التكامل الأساسي عبر lifecycle hooks
• Codex CLI — عبر T3 Code
• OpenCode
• Grok Bot (xAI)
• OpenClaw Gateway — تثبيت بسطر واحد
• Antigravity CLI (Google)
• OMP (Oh My Pi)
• Cursor، Gemini، Hermes، GitHub Copilot، Windsurf — كلها مدعومة

مش هتلاقي coding agent جاد مش مدعوم.

الـ Architecture — 6 مكونات

1) 5 Lifecycle Hooks

• SessionStart — يحقن الذاكرة في بداية الجلسة
• UserPromptSubmit — يسجّل كل prompt
• PostToolUse — يسجّل كل استدعاء أداة
• Stop — يسجّل انتهاء الـ turn
• SessionEnd — يضغط الجلسة ويحفظ الـ observations

2) Worker Service

HTTP API محلي بـ web viewer UI لمتابعة الذاكرة real-time. يُدار بواسطة Bun (أسرع من Node).

3) SQLite + FTS5

قاعدة بيانات محلية بـ full-text search مدمج. تحفظ الجلسات والـ observations والـ summaries.

4) Chroma Vector DB

بحث semantic + keyword hybrid لاسترجاع ذكي للـ context. بتسأل بلغة طبيعية والنظام يفهم المعنى مش بس الكلمات.

5) mem-search Skill

Claude Skill مدمج بيدي Claude قدرة البحث في الذاكرة بـ natural language queries.

6) 4 MCP Search Tools

• search — index سريع بـ IDs (~50-100 token لكل نتيجة)
• timeline — context زمني حوالين observation معيّن
• get_observations — تفاصيل كاملة للـ IDs اللي تختارها

الـ 3-Layer Workflow — توفير 10x في الـ tokens

// Step 1: ابحث للحصول على index
search(query="authentication bug", type="bugfix", limit=10)

// Step 2: راجع الـ IDs المهمة (مثلاً #123, #456)

// Step 3: اجلب التفاصيل الكاملة لبس اللي تحتاجه
get_observations(ids=[123, 456])

الفلسفة: Progressive Disclosure — ابدأ بـ summary خفيف، ثم اعمق تدريجياً فقط للـ observations اللي محتاجها فعلاً. ده بيوفر ~90% من الـ tokens مقارنة بتحميل كل الـ context دفعة واحدة.

Quickstart — سطر واحد

npx claude-mem install

الـ installer بيعمل كل حاجة ثم يطلب منك تسجيل دخول (email magic link، بدون كارت). التسجيل بيدي:

تقدر تتخطى التسجيل بـ --provider flag أو CLAUDE_MEM_ONLINE_OPTIN=false.

تثبيت لـ OpenClaw Gateway

curl -fsSL https://install.cmem.ai/openclaw.sh | bash

تثبيت من Claude Code marketplace

/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem

الخصوصية — <private> tags

تقدر تحوّط أي معلومة حساسة بـ <private>...</private> فـ Claude-Mem يتجاهلها عند حفظ الذاكرة. مفيد للـ API keys والـ tokens والبيانات الشخصية.

الـ Modes واللغات

الـ observations ممكن تتسجّل بأي لغة عبر CLAUDE_MEM_MODE:

{
  "CLAUDE_MEM_MODE": "code--ar"
}

النمط code--ar هيخلي الـ observations بتتسجّل بالعربية. فيه نسخ built-in للصيني واليابان، والعربية ممكن تضيفها.

⚠️ ملحوظة شفافة — توكن CMEM

فيه CMEM token على شبكة BASE blockchain (CA: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3). الـ README بيوضح إن التوكن طرف ثالث عمله، لكن الكريتور (Alex Newman) اعتمده كـ “community catalyst”.

الحكم العملي: المشروع نفسه مفتوح وشغّال ومرخّص Apache 2.0. التوكن حاجة منفصلة. تقدر تستخدم الأداة بدون أي تعرض للـ crypto. لكن لو حابب تحذر العملاء، الوجود ده موجود.

Claude-Mem مقابل Hindsight (المقال السابق)

• Hindsight (Vectorize) — ذاكرة لأي AI agent، multilingual، مركّزة في SDK/API
• Claude-Mem — ذاكرة متخصصة لـ coding agents، تكامل عميق مع lifecycle hooks

مش منافسين، منتجين مختلفين. Claude-Mem للـ IDE development، Hindsight للـ production AI apps.

سيناريو Ibrahim المباشر

• مشاريعك الكتير (CRM، doctors، expenses، lecture-docs، n8nar، faahm، bond) — كل مشروع له جلسات Claude Code متعددة. Claude-Mem هيوفر عليك إعادة شرح كل مرة.
• الـ opencode server على Cloudflare Tunnel — ركّبه بـ --ide opencode فتبقى الذاكرة متاحة في أي مكان بتتصل منه.
• كورس Vibe Coding + كورس Claude — درس كامل عن “ازاي تخلي Claude يفتكر مشروعك” مع demo عملي. ده بالذات هيبقى hook قوي للـ marketing.
• فرصة Agency — تضيف Claude-Mem setup كخدمة لعملاء DSE اللي بيستخدمو Claude Code. سعر: 3-5 ألف جنيه setup + صيانة.
• الـ CMEM token الموضوع ده — تجنّبه كلياً في المحتوى الموجّه للعملاء. ركّز على الأداة.

📎 رابط المشروع: github.com/thedotmack/claude-mem