ذاكرة وكلاء البرمجة مع ai-memory المكتوب بلغة Rust: يمنح هذا المشروع مفتوح المصدر وكلاءك (Claude Code وCodex وCursor وGemini CLI وOpenCode وأكثر من عشرين أداة تشغيل أخرى) ذاكرة طويلة مشتركة، مخزنة في صفحات Markdown مُؤرشفة الإصدارات بواسطة Git. يعرض مستودع akitaonrails/ai-memory نحو 12 600 نجمة في نهاية أكتوبر 2026، بترخيص MIT.
فكرة README: أن تغادر Claude Code في منتصف مهمة، وتفتح Codex في المجلد نفسه، وتستأنف من دون أن تعيد شرح البنية والمسارات المتروكة والأسئلة المفتوحة. يعرض هذا المقال المشروع وتثبيته بحسب README وما تُظهره واجهته على الويب وحدوده (البيانات الملتقطة، وحداثة المشروع) وطريقة مراقبته بمقاييس Prometheus الخاصة به. توضيح للأمانة: لم تثبّت span.observer برنامج ai-memory؛ الأوامر مأخوذة من README واللقطات مأخوذة من المستودع.
ذاكرة وكلاء البرمجة مع ai-memory: ما يقوله المستودع
- الجهة: المستودع تابع للحساب
akitaonrails، بترخيص MIT (حقوق النشر 2026 باسم المشرف). وموقعه aimemory.sh. - أرقام قُرئت في 22 أكتوبر 2026: نحو 12 600 نجمة ونحو 889 تفرّعًا (fork) و4 344 إيداعًا (commit)؛ ويظهر الإصدار 3.2.0 في سجل التغييرات بتاريخ 21 أكتوبر 2026؛ وسلسلة الأدوات المطلوبة هي Rust 1.95 أو أحدث.
- البنية: ملف ثنائي Rust مستقل يخدم MCP وHTTP ويملك مجلد بيانات فيه ويكي Markdown مُؤرشف الإصدارات (مصدر الحقيقة)، وفهرس SQLite مشتق (FTS5 وكيانات وتضمينات embeddings اختيارية)، وسجلات.
- الدورة: التقاط عبر خطافات (hooks) دورة الحياة (المطالبات واستدعاءات الأدوات وحدود الجلسة)، ثم دمج في صفحات في نهاية الجلسة، ثم استرجاع بالبحث وحقن ملخص، ثم «handoff» إلى الوكيل التالي.
يشدّد المشروع على نقطة: المسار الافتراضي لا يستخدم أي استدعاء لـ LLM. فالالتقاط والبحث وعمليات handoff تعمل من دون مفتاح API، أما الوظائف التي تعيد كتابة المحتوى (الضغط compaction وإزالة التكرار و«dream») فاختيارية ومعطّلة افتراضيًا. وللمقارنة مع مقاربات أخرى لذاكرة الوكلاء اقرأ مقالنا عن Hindsight؛ فالـ README نفسه يذكر Hindsight في جدوله المقارن.
جولة في واجهة الويب
يمكن بدء الخادم بالخيار --enable-web ليوفر عرضًا للويكي للقراءة فقط في المتصفح، ورسمًا للروابط (/web/graph)، وواجهة JSON تحت /api/v1. تُظهر اللقطة أدناه، المأخوذة من المستودع، مشروعًا بصفحاته مصنفة بحسب المجلد (concepts/ وdecisions/ وgotchas/ وsessions/) والنشاط الأخير.

في شاشة الاستقبال يذكّر تنبيه من المشروع بأن هذه الصفحات «LLM-optimised memory, not hand-curated documentation»: مُجمَّعة لتستردها الوكلاء لا لتقرأها العين البشرية. والمتصفح يخدم تدقيق ما سُجّل.

التثبيت خطوة بخطوة
الخطوة 1 — Linux وmacOS
يقترح README أمرين، من دون صلاحيات root:

بحسب README ينزّل install.sh النسخة الخاصة بنظامك ويقارنها بمجموع SHA-256 المنشور (ويرفض التثبيت من دون تطابق)، ثم ينشئ رابطًا في ~/.local/bin. وينشئ ai-memory setup مجلد البيانات مع رمز مميّز (token) في ملف مقصور على المالك، ويشغّل خدمة مستخدم (systemd أو launchd)، ويهيّئ MCP والخطافات والمهارات (skills) للوكلاء التي يجدها بعد التأكيد. ويعرض الخيار --plan الخطة من دون تعديل أي شيء.
الخطوة 2 — Windows ومنصات أخرى
على Windows يعطي README أمرَي PowerShell (install.ps1 ثم ai-memory setup)، ويصنّف Windows الأصلي «تجريبيًا» (experimental)؛ أما Windows عبر WSL2 فـ«مدعوم». وتوجد حزم لـ Arch (AUR) وFedora (RPM) وNixOS، وتطبيق لشريط القوائم في macOS، وصورة Docker.
الخطوة 3 — تشغيل وكيل
ينصح README ببدء الوكيل بالأمر ai-memory run claude (أو codex): يوصل المُطلِق الخطافات وMCP إن غابت، ويضيف استمرارية الجلسة بين أدوات التشغيل. ثم أعد تشغيل وكلائك واسألهم «What do you remember about this project?» للتحقق.
الحدود والنقاط المفتوحة
- ما يُلتقط: تسجّل الخطافات المطالبات واستدعاءات الأدوات، بعد تنقيتها بحدّ خصوصية قبل التخزين. ويوضح الملف DATA_HANDLING.md أنه لا يوجد تشفير في حالة السكون (at rest) في الإصدار الأول، ويعتمد على صلاحيات نظام الملفات. وتتيح قواعد
[capture]لكل مستودع استبعاد مسارات. - المصادقة: ينبّه README إلى أن البدء السريع عبر Docker لا يتضمن أي مصادقة (ربط على الحلقة المحلية فقط). أما التثبيتات الأصلية مع
ai-memory initفتحصل على رمز مميّز. أضف TLS عبر بروكسي عكسي (reverse proxy) متى خرج الخادم من الجهاز. - مسارات خارجية اختيارية: افتراضيًا كل شيء محلي، مع تضمينات محلية. أما مزوّد LLM أو تضمينات بعيد فيرسل المحتوى إلى ذلك المزوّد إن فعّلته.
- النضج: ينشر المشروع إصدارات رئيسية متقاربة، ويعلن Windows الأصلي تجريبيًا، ويذكر في شكره أنه بُني بالتعاون مع Claude Code. اقرأ سجل التغييرات قبل كل تحديث.
- ذاكرة خاطئة: قد تحتفظ ذاكرة تلقائية باستنتاج خاطئ. ويذكر README «contradiction flagging» (وسم التناقضات)، لا ضمانًا للصحة.
كيف تراقب ai-memory؟
ai-memory خدمة محلية طويلة العمر: تُراقَب كما هي. بحسب وثائق المستودع توجد ثلاثة مصادر. يعطي الأمر ai-memory status --json (المكافئ لـ GET /admin/status، وهو محمي) الحالة، بما فيها تتبعًا لاستدعاءات LLM بحسب نوع العمل متى هُيّئ مزوّد. وتعرض نقطة GET /admin/metrics بصيغة نص Prometheus عدّادات للخطافات بحسب النتيجة، واستدعاءات أدوات MCP مفصولة بين قراءة وكتابة، ومدرّجات تكرارية لزمن الاستجابة لـ POST /hook وmemory_query؛ وتأتي الوسوم من مجموعة مغلقة ولا يمكن أن يظهر فيها نص استعلام ولا اسم مشروع ولا رمز. وأخيرًا يعرض /web/health طابور الكتابة ومخزن الخطافات المؤقت (spool) وطابور الدمج.
ويوضح المستودع أنه لا يوجد مُصدِّر OpenTelemetry: تعود العدّادات إلى الصفر عند إعادة التشغيل، وتصدير OTLP مدوَّن بعبارة «يُقاس أولًا». ولإرسالها إلى Dynatrace يمكن أن يقرأ OpenTelemetry Collector النقطة /admin/metrics بمستقبِل Prometheus، كما يشرح مقالنا عن OpenTelemetry وPrometheus، مع احترام مصادقة الخادم. وهذا ينطبق على Dynatrace SaaS؛ أما في Dynatrace Managed فتحقق من دعم استيعاب مقاييس OTLP.
من جهة الوكيل، يُقاس الأثر في التكلفة (الملخص المحقون يستهلك رموزًا) بتتبع الوكيل نفسه، راجع تكلفة وكيل الذكاء الاصطناعي بالرموز مع OpenTelemetry ومراقبة وكيل برمجة في المؤسسة.
كيف تتحقق من أن كل شيء يعمل؟
- لا يشير
ai-memory statusوai-memory doctorإلى أي تحذير مانع. - بعد جلسة تظهر صفحة في الويكي (عرض الويب أو ملفات Markdown).
- في وكيل جديد داخل المجلد نفسه، يستأنف السؤال «where did we leave off?» من handoff.
أفضل الممارسات
- ابدأ على مستودع بلا أسرار، مع تطبيق قواعد الاستبعاد
[capture]. - أبقِ الخادم على الحلقة المحلية؛ وإلا فرمز مميّز وحسابات وTLS.
- انسخ مجلد البيانات احتياطيًا (يصف README نسخًا احتياطيًا إلى مستودع Git بعيد) وراجع الصفحات المسجَّلة.
- ثبّت الإصدار واقرأ ملاحظات التحديث قبل الترحيل.
الأسئلة الشائعة
هل يحتاج ai-memory إلى LLM أو مفتاح API؟
لا افتراضيًا: الالتقاط والبحث وعمليات handoff تعمل من دون استدعاء LLM. ولا يفيد المزوّد إلا في تحسين الملخصات والبحث الدلالي، إن هيّأته.
هل تغادر البيانات جهازي؟
بحسب DATA_HANDLING.md، لا افتراضيًا: يقول المشروع إنه لا يرسل بيانات تتبع. أما بعض الخيارات (مزوّد LLM أو تضمينات بعيد، خادم مشترك) فترسل المحتوى إلى حيث توجّهها.
هل يمكن مشاركته داخل فريق؟
نعم، بحسب README: خادم مشترك، بمصادقة متعددة المستخدمين ونسبة المحتوى إلى أصحابه وسجل تدقيق. وتبقى عمليات handoff الشخصية شخصية.
الخلاصة
يقترح ai-memory ذاكرة وكلاء برمجة شفافة: ملفات Markdown تملكها، وملف Rust ثنائي واحد، وعملًا بلا LLM افتراضيًا. وهو يلتقط محتوى كثيرًا: عليك أن تقرر ماذا وأين وبأي مراقبة. المصادر: مستودع akitaonrails/ai-memory.
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC ولا للمشاريع المذكورة. العلامات التجارية المذكورة ملك لأصحابها. الأدوات تتطور بسرعة، لذا تحقق دائمًا من الأوامر والخيارات في وثائقها الرسمية.