عن المشروع

jevgrep هي أداة سطر أوامر لوكلاء البرمجة تستبدل جزءاً من عملية اكتشاف الملفات اليدوية بالبحث باللغة الطبيعية. فبدلاً من تخمين أسماء الملفات أو البحث عن الرموز باستخدام grep، يطرح المستخدم سؤالاً مثل "كيف يتم تسجيل أحداث القياس وإرسالها؟" فتقوم الأداة باستكشاف تسلسل المستودع، وتختار الملفات باستخدام معاينات المحتوى، وتحدد وحدات الشيفرة المصدرية ذات الصلة، وتعيد ملخصاً وقائمة ملفات مختصرة ومقتطفات مصدرية حرفية مع مراجع الأسطر ومواقع التعريفات أو الاستدعاءات في استجابة واحدة على stdout. تستخدم الأداة Jev عبر مزوّد قابل للتهيئة للحكم على الصلة عبر المجلدات والملفات والتعريفات. تشمل المزوّدات المدعومة Vercel AI Gateway وTypeSafe وOpenRouter وOpenCode Zen ونقاط نهاية مخصصة متوافقة مع TypeSafe. وتتطلب Node.js 22+ على macOS أو Linux ولا تحتاج إلى تثبيت Python أو Bun أو ripgrep بشكل منفصل. تتوفر مهارة وكيل مرافقة عبر `jg skill` أو `npx skills add dzhng/jevgrep --skill jevgrep`. يكتشف المثبّت وكلاء البرمجة مثل Claude Code وCodex وOpenCode ويشرح كيفية استدعاء أداة سطر الأوامر وتفسير السياق المُعاد. تتم المصادقة عبر `jg auth`، الذي يخزّن مفتاح المزوّد في ملف تهيئة مخصص للمالك فقط. يُدعم تحليل التعريفات في Python وTypeScript/JavaScript وGo وRust، مع آلية احتياطية للنصوص الأخرى. يحترم التصفية الافتراضية لنظام الملفات ملفات التجاهل ويستبعد الملفات المخفية وملفات التبعيات/البناء والملفات الثنائية وملفات بيانات الاعتماد الواضحة. يحسب الأمر `jg files` عدد الملفات التي قد يقرأها البحث دون إجراء طلبات شبكة، ويقبل `--exclude` أنماطاً بأسلوب gitignore للاستبعادات لكل بحث. يتضمن المستودع سجلات تقييم مبنية على عشر مهام Python SWE-bench مضبوطة. ويُفيد المشروع بأن Jevgrep حلّت نفس 8 من 10 مهام كما فعل خط أساس بدون Jev مع تقليل تكلفة Sol المقاسة بنحو 28.6%، وتتضمن التقييمات اللاحقة قياسات تكلفة مشتركة لـ Sol مع Jev. وهذه ملاحظات من تشغيل واحد وليست ضمانات إحصائية. المشروع مكتوب بـ TypeScript باستخدام Bun workspaces وTurborepo، ومنشور تحت رخصة MIT.