ليش اشتراكك بيخلص بنص الشهر
كل مرة بتفتح Session جديد في Claude Code، بيبلّش من الصفر: بيرجع يقرأ الـ System Prompt، والـ Skills، وملف CLAUDE.md، وملفات المشروع — من أول وجديد.
- يعني آلاف الـ Tokens بتنحرق قبل ما تكتب أول كلمة
- وكل ما احتاج يفهم شي، بيفتح ملفات كاملة ويقرأها — حتى لو بده منها سطرين
- النتيجة: اشتراكك بيخلص وإنت مش عارف وين راح
الحل اللي حكيت عنه بالريل: أداة مجانية بتبني للمشروع Knowledge Graph — دماغ تاني، فبدل ما يقرأ ملفات كاملة، بيسأل الجراف وبياخد بس اللي بده إياه.
الأداة: Graphify
Graphify (من Graphify Labs) بتحوّل مشروعك كله — الكود، التوثيق، ملفات SQL، الإعدادات، وحتى الـ PDF — لجراف معرفي قابل للسؤال. مجانية ومفتوحة المصدر (MIT / Apache-2.0).
- الكود بيتحلل محلياً 100% — بتقرأ بنية الكود بـ tree-sitter بدون أي نموذج ذكاء اصطناعي: ما بيطلع شي من جهازك، وبناء الجراف للكود بصفر Tokens
- 37 لغة برمجة مدعومة: Python، TypeScript، JavaScript، Go، Rust، Java، PHP وغيرها
- بتشتغل مع 15+ مساعد برمجة: Claude Code (الأساسي)، Cursor، Codex، Gemini CLI…
- بلا تتبّع: no telemetry، ولا vector store، ولا embeddings
بعد البناء بتطلعلك 3 ملفات بمجلد graphify-out/:
| الملف | شو هو |
|---|---|
| graph.html | الجراف التفاعلي — بتشوف مشروعك كشبكة عقد وروابط (اللقطة اللي بالريل) |
| GRAPH_REPORT.md | أبرز النقاط + أسئلة مقترحة تبدأ فيها |
| graph.json | الجراف نفسه — هذا اللي Claude بيسأله بدل ما يقرأ الملفات |
التثبيت — 3 أوامر
Graphify بدها Python 3.10+ ومدير الحزم uv. إذا ما عندك uv، ثبّته أولاً:
Windows انسخ في PowerShell:
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
Mac / Linux انسخ في Terminal:
curl -LsSf https://astral.sh/uv/install.sh | sh
1) ثبّت Graphify (سكّر الـ Terminal وافتحه من جديد بعد تثبيت uv):
uv tool install graphifyy
2) اربطها بـ Claude Code (بتركّب الـ Skill لحالها):
graphify install
3) افتح claude بمجلد مشروعك وابني الجراف:
/graphify .
خلص — أول جراف انبنى. افتح graphify-out/graph.html بالمتصفح وشوف مشروعك كشبكة.
بتستخدم Cursor أو Codex أو Gemini CLI؟ نفس الشي مع graphify install --platform cursor (أو codex / gemini).
كيف بتوفّر عليك — الاستخدام اليومي
القاعدة: اسأل الجراف بدل ما تخلّي Claude يقرأ ملفات. الجواب بيرجع subgraph صغير ومركّز — Tokens أقل بكثير من فتح الملفات نفسها.
| الأمر | شو بيعمل |
|---|---|
| /graphify . | بناء الجراف لأول مرة (الكود محلياً بصفر Tokens) |
| /graphify --update | تحديث الجراف — بيعيد قراءة الملفات اللي تغيّرت بس |
| graphify query "..." | سؤال الجراف: «شو بيربط الـ auth بقاعدة البيانات؟» |
| graphify path "A" "B" | أقصر طريق بين مكونين — كيف بيوصلوا ببعض |
| graphify explain "X" | شرح مكوّن أو مفهوم من الجراف |
| graphify hook install | تحديث تلقائي للجراف مع كل git commit — ذاكرة بتضل حديثة لحالها |
أوامر جاهزة — انسخ وجرّب
1) أول جلسة بعد بناء الجراف:
قبل ما تقرأ أي ملف: اسأل جراف Graphify عن كل شي متعلق بـ [المهمة] واعتمد على نتائجه. افتح ملفات كاملة بس إذا الجراف ما كفى.
2) افهم مشروع جديد عليك بدقايق:
شغّل graphify explain على المكونات الرئيسية بالمشروع واعرضلي: شو بيعمل كل واحد، وكيف مربوطين ببعض. بعدها اقترح من وين أبدأ التعديل لإضافة [الميزة].
3) قبل ما تعدّل شي حساس:
شغّل graphify query "شو بيعتمد على [اسم الملف/المكوّن]؟" وقلّي شو ممكن ينكسر إذا عدّلته.
4) بعد ما تخلص شغل:
شغّل /graphify --update حتى الجراف يلحق آخر التغييرات.
حل المشاكل + أسئلة شائعة
| المشكلة | الحل |
|---|---|
| graphify: command not found | سكّر الـ Terminal وافتحه من جديد بعد uv tool install graphifyy — الـ PATH بده يتحدث |
| uv مش مثبّت / Python قديم | Graphify بدها Python 3.10+. ثبّت uv بأمر الخطوة 3 وهو بيدبّر Python لحاله |
| /graphify مش ظاهر في Claude | شغّل graphify install وأعد فتح جلسة claude |
| الجراف ضخم / فيه ملفات مالها لزوم | أضف ملف .graphifyignore (بنفس صيغة .gitignore) واستثني build/ و node_modules/ وغيرها |
| الجراف صار قديم | /graphify --update، أو فعّل التحديث التلقائي: graphify hook install |