عن المشروع

# Crit Crit أداة محلية ذات ملف تنفيذي واحد تسد الفجوة بين وكلاء الذكاء الاصطناعي والمراجعة البشرية. توفر واجهة تكيفية لأنواع مختلفة من مخرجات الوكلاء—خطط markdown، وفروقات الكود، وتطبيقات الويب الحية، وHTML الثابت—حتى تتمكن من الإشارة إلى المشكلة الدقيقة وترك تعليقات مضمّنة ليعالجها وكيلك. ## القدرات الرئيسية - **واجهة مراجعة تكيفية**: `crit plan.md` يعرض markdown مع واجهة مراجعة؛ `crit` يكتشف تغييرات git تلقائياً لعرض فروقات مع تمييز نحوي؛ `crit http://localhost:3000` يعمل كوكيل لخادم تطوير قيد التشغيل؛ `crit landing.html` يراجع HTML الثابت. - **تكامل مع الوكلاء**: يعمل مع Claude Code وCursor وGitHub Copilot وOpenCode وCodex وGemini وQwen وHermes وWindsurf وCline وGrok وAider وPi. تتضمن معظم عمليات التكامل أمر `/crit` الشرطي الذي يؤتمت حلقة المراجعة الكاملة. - **تعليقات مضمّنة**: انقر على رقم سطر أو اسحب لتحديد نطاق للتعليقات، تُعرض مضمّنة مثل مراجعة GitHub PR. - **فرق من جولة إلى جولة**: بعد تعديل وكيلك، يعرض Crit فروقات منقسمة أو موحّدة لما تغيّر. - **تعليقات برمجية**: يمكن لوكلاء الذكاء الاصطناعي استخدام `crit comment` لإضافة تعليقات مراجعة مضمّنة دون فتح واجهة المتصفح. - **مشاركة غير متزامنة**: شارك المراجعات عبر رابط عام لآراء إضافية؛ التعليقات مرمّزة بالألوان حسب المؤلف. يدعم تسجيل الدخول المجهول أو GitHub oAuth. - **مزامنة GitHub PR / GitLab MR**: مزامنة تعليقات ثنائية الاتجاه مع طلبات السحب/الدمج، بما في ذلك أحداث السحب والدفع والموافقة وطلب التغييرات. - **الإرسال إلى الوكيل (تجريبي)**: اضبط `agent_cmd` للحصول على ردود ذكاء اصطناعي فورية على التعليقات، مع أوضاع الأذونات (كاملة، انتقائية، أو بدون أذونات). تحافظ المحادثات الحية على استمرارية النقاش. - **وضع القصة**: للفروع/طلبات السحب الكبيرة، يولّد نظرة عامة مقسّمة إلى فصول على الفرق (فصول موضوعية، مقدمة، حاوية دعم) لفهم شكل التغيير قبل المراجعة سطراً بسطر. - **الوضع الحي**: اعمل كوكيل لخادم تطوير قيد التشغيل مع تمرير ملفات تعريف الارتباط (عبر `--cookie` أو `--cookie-file` أو Chrome CDP) للتطبيقات الموثّقة. ## ميزات إضافية - عزل المراجعة لكل فرع (البيانات في `~/.crit/reviews/`) - حفظ تلقائي للمسودات، اختصارات Vim، مراجعات متزامنة، تمييز نحوي، مراقبة حية للملفات - سمة داكنة/فاتحة/حسب النظام، خط كود قابل للضبط - محلي افتراضياً (يرتبط بـ 127.0.0.1)؛ لا قياس عن بُعد أو تتبع - قابل للضبط عبر ملفات JSON عامة (`~/.crit.config.json`) ومشروع (`.crit.config.json`) ## البدء السريع ثبّت عبر Brew أو Go أو Nix أو ملف Windows التنفيذي. لـ Claude Code: ``` claude plugin marketplace add tomasz-tomczyk/crit claude plugin install crit@crit ``` ثم استدعِ `/crit` بعد أي عمل. ينتظر Crit مراجعتك ويتصرف الوكيل بناءً على الملاحظات، متكرراً حتى توافق. ## أبرز إعدادات الضبط - `agent_cmd`: أمر "الإرسال إلى الوكيل" (عام فقط لأسباب أمنية) - `forge`: اكتشاف تلقائي لـ GitHub أو GitLab - `share_targets`: عمليات نشر مشاركة متعددة - `live_cookie_file` / `live_cdp_url`: تمرير ملفات تعريف الارتباط للوضع الحي - `cleanup_on_approve`: حذف ملفات المراجعة تلقائياً عند الموافقة - `notify_on_round_ready`: إشعارات سطح المكتب عند جاهزية جولة مراجعة