عن المشروع

zvec-grep (zg) هي طبقة بحث محلية أولاً لمساحات العمل، مصممة لكل من المستخدمين البشر ووكلاء الذكاء الاصطناعي. وهي تجمع بين ripgrep وBM25 والبحث المتجهي خلف واجهة واحدة، ما يتيح للمستخدمين البحث حسب المعنى، وترتيب النتائج حسب الصلة، والتحقق من النتائج بنص دقيق أو تعبير نمطي. تدعم الأداة الشيفرة المصدرية والمستندات والبيانات المهيكلة مع الحفاظ على البنية ومواقع المصدر. تشمل الميزات الرئيسية واجهة سطر أوامر وتكاملات مع الوكلاء، والبحث متعدد الصيغ، ونتائج مرتبة مرتبطة بالمصدر، والتشغيل المحلي افتراضياً حيث تبقى الملفات والفهارس والنماذج المحلية على جهاز المستخدم. ولا تُستخدم التضمينات البعيدة إلا بإذن. ويوفر المشروع تنفيذاً بـ TypeScript/Node.js، مع تنفيذ منفصل بلغة Rust قيد التطوير. يتطلب التثبيت Node.js 22 أو أحدث. ويمكن للمستخدمين التثبيت عالمياً عبر npm، وفهرسة مساحة عمل باستخدام `zg index`، والاستعلام عنها باستخدام `zg query`. وتتوفر تكاملات الوكلاء مع OpenCode وCodex وClaude Code وQwen Code وQoder وCursor وGitHub Copilot وVS Code وGrok Build وغيرها. كما تدعم الأداة MCP لوصول آمن للوكلاء. تغطي الوثائق تكاملات الوكلاء، واستخدام سطر الأوامر، وMCP، وخط أنابيب الاسترجاع، والبنية، وأوضاع الخادم والتنفيذ، ونماذج التضمين، وخارطة الطريق. وتشمل المعايير تقييمات الوكلاء عبر المجالات على SWE-QA-Bench وBrowseComp-Plus، إضافة إلى دراسات حالة واقعية مع مستودعات Pylint وMatplotlib وDjango.