عن المشروع

Releases CLI هو عميل سطر الأوامر لـ releases.sh، وهو سجل مستضاف يفهرس ملاحظات الإصدارات وسجلات التغييرات وإعلانات المنتجات المجمعة من GitHub وخلاصات RSS/Atom/JSON وصفحات سجلات تغييرات المنتجات. يحتوي هذا المستودع على CLI فقط؛ أما عامل API وخادم MCP والواجهة الأمامية للويب وخط أنابيب الاستيعاب فتقع في مستودع خلفي منفصل. يعمل البحث والتصفح دون حساب أو إعدادات، لأن CLI يتواصل مع API المستضاف. ويفتح تسجيل الدخول ميزات شخصية: متابعة المؤسسات والمنتجات، وخلاصة إصدارات مخصصة، وخطافات ويب صادرة. يستخدم تسجيل الدخول OAuth 2.0 Device Authorization Grant، عبر الموافقة على رمز قصير في متصفح مسجّل الدخول؛ ولا يُخزَّن محليًا سوى مفتاح API للقراءة فقط (في ‎~/.releases/credentials بصلاحيات 0600)، وليس جلسة المتصفح أبدًا. ويوصَف الوصول للكتابة والإدارة بأنه نسخة تجريبية مغلقة منفصلة. تشمل خيارات التثبيت Homebrew وnpm (تثبيت عام أو npx) ومثبّت shell وملفات ثنائية مسبقة الترجمة موقّعة تُنشر مع مجاميع تحقق للتركيبات المعزولة أو المثبّتة على إصدار محدد. وتُثبَّت إكمالات shell تلقائيًا عبر Homebrew ويمكن تمكينها في مواضع أخرى باستخدام أمر completion. تغطي الأوامر الأساسية البحث في الإصدارات (مع إمكانية تحديد نطاق تاريخ النشر باختصار نسبي مثل 90d أو 4w)، ومتابعة أحدث الإصدارات لمنتج، والسرد حسب الفئة، وجلب مؤسسة أو منتج أو مصدر، وعرض نظرة عامة على المؤسسة مولّدة بالذكاء الاصطناعي، وإحصاءات السجل، وسجل تغييرات المشروع نفسه، وإرسال رابط مصدر أو ملاحظات. المعرّفات قابلة للتبادل: slugs أو IDs مصنّفة أو إحداثيات org/slug كلها تعمل، وIDs مستقرة عبر إعادة التسمية. تقبل أوامر القراءة علم JSON، حيث تصدر أوامر القوائم غلاف items/pagination، وتوفر قارئات الإصدارات شكلًا افتراضيًا مختصرًا أو حمولة كاملة. تدير أوامر follow وfeed خطًا زمنيًا شخصيًا للمؤسسات والمنتجات المتابَعة. وتسجّل أوامر webhook طلبات POST موقّعة من نوع release.created، إما مقيّدة بمؤسسة (حتى عشرة، مع مرشحات اختيارية للمصدر والمنتج والنوع) أو مرتبطة بمخطط المتابعة الحالي (خطاف ويب واحد). وتُعرض مفاتيح التوقيع مرة واحدة عند الإنشاء أو التدوير، ويتحقق أمر verify من التوقيعات محليًا. ويمكن أيضًا إدارة خطافات الويب في مساحة عمل مشتركة، حيث يجوز للمالكين والمسؤولين فقط إنشاءها أو تعديلها أو تدويرها أو حذفها، بينما يمكن لأي عضو سردها وعرضها واختبارها. لا تحتاج أوامر المساهمة إلى حساب: إرسال رابط سجل تغييرات، وإرسال ملاحظات عن أخطاء أو أفكار، والتحقق من صحة manifest بصيغة releases.json v2 مقابل المخطط المنشور دون اتصال. ويدعم كل من submit وfeedback المطالبات التفاعلية وإدخال stdin ومعاينات JSON التجريبية. بالنسبة لوكلاء الذكاء الاصطناعي، يشير المشروع إلى خادم MCP مستضاف يمكن الوصول إليه عبر mcp-remote، ويعمل المستودع أيضًا كإضافة لسوق Claude Code توفر أدوات MCP المستضافة وأمر lookup ومهارات التشغيل التلقائي. ويضيف أمر skills install المهارات إلى أدوات وكلاء أخرى أيضًا. تسمح متغيرات البيئة بتجاوز مفتاح API وعنوان API الأساسي، وتعطيل القياس المجهول. وبالنسبة للوكلاء المعترضة لـ TLS، يحترم الملف الثنائي المترجم متغيرات شهادة CA القياسية الخاصة بـ Node/OpenSSL. وتميّز رموز الخروج الموثقة بين النجاح وأخطاء التطبيق وأخطاء الاستخدام أو المزوّد والإلغاء. المشروع مرخّص بموجب MIT.