Install
curl -fsSL https://raw.githubusercontent.com/manishiitg/coding-agent-loop/main/install.sh | bashلمن هذه المنصة
التموضع الرسمي لـ AgentWorks هو منصة وكلاء ذكاء اصطناعي مدفوعة بالهدف ومتاحة المصدر (source-available): تُسند إلى الوكيل مؤشر هدف، فيواصل العمل حتى يبلغه. إذا كنت تستخدم بالفعل واجهات CLIs لوكلاء البرمجة مثل Claude Code وCodex وCursor وPi وMuse، فإنه يعمل مباشرة فوق هذه الواجهات القائمة.
وهو في الوقت نفسه خادم MCP: إذا أردت فحص الأهداف وقراءة التقارير وبدء التشغيلات مباشرة من محادثة في ChatGPT أو Claude (Desktop وCode وCowork) أو أي عميل MCP، فهو مناسب تمامًا.
شروط ينبغي الانتباه إليها: مسار التثبيت الموثق رسميًا يغطي macOS فقط (يُثبَّت في /Applications، وتُزال علامة الحجر الصحي في macOS، ويُثبَّت Go عبر Homebrew عند الحاجة)؛ ولا ذكر لأنظمة التشغيل الأخرى. كما أنه ليس خدمة مُدارة جاهزة للاستخدام: عند التشغيل الأول يجب أن تختار بنفسك مجلد مساحة عمل محليًا وتضبط AUTH_SECRET.
أول تجربة في 3 دقائق
المتطلبات: جهاز macOS وطرفية؛ والسكربت يثبّت Go عبر Homebrew عند الحاجة.
نفّذ في الطرفية أمر التثبيت الرسمي المكون من سطر واحد:
curl -fsSL https://raw.githubusercontent.com/manishiitg/coding-agent-loop/main/install.sh | bash
قبل أن تضغط Enter، افحص الآثار الجانبية: ينزّل السكربت أحدث إصدار (release)، ويثبّت AgentWorks.app في /Applications، ويثبّت جسر MCP الذي يعتمد عليه Claude Code وCodex للوصول إلى الأدوات (يوضع في ~/go/bin)، ويزيل علامة الحجر الصحي في macOS، ثم يشغّل التطبيق. هذا إجراء تثبيت يتضمن كتابات محلية وليس عملية قراءة فقط؛ وإذا كان لديك تحفظ على السكربتات البعيدة فراجع محتوى ذلك الرابط في المتصفح أولًا.
إعداد التشغيل الأول: اتبع إرشادات التطبيق لاختيار مجلد مساحة عمل وضبط AUTH_SECRET. يُستخدم لتشفير مفاتيح المزودين (provider keys)؛ وإذا فُتحت مساحة العمل نفسها على عدة أجهزة فيجب أن تعيد كل جهاز استخدام القيمة نفسها.
أول استدعاء منخفض المخاطرة: سبق للسكربت أن ثبّت جسر MCP لكل من Claude Code وCodex، فاطلب من Claude Code فحص الأهداف (check goals) أو قراءة التقارير (read reports)؛ وهذان من قدرات القراءة الموصوفة رسميًا ولا يشغّلان أي تشغيل. إشارة النجاح: أن يعيد Claude Code حالة الأهداف أو محتوى تقرير. خطوات ربط عملاء MCP الآخرين (مثل ChatGPT وClaude Desktop) غير معروضة في الصفحة الرسمية، ولن نختلقها هنا.
حالات الاستخدام
الحالة الأولى: فحص التقدم وقراءة التقارير من المحادثة. السيناريو: كنت قد سلّمت AgentWorks هدفًا يطارد مؤشرًا وتريد متابعة سيره من محادثاتك اليومية. الطريقة: اطلب من عميل متصل بالفعل، بلغة طبيعية، فحص الأهداف وقراءة التقارير (check goals, read reports). النتيجة المتوقعة: يدعم المسؤول صراحة عرض الأهداف وقراءة التقارير من تلك المحادثة؛ أما حقول الإرجاع المحددة فغير مذكورة، والمعتمد هو المخرجات الفعلية.
الحالة الثانية: بدء تشغيل من المحادثة. السيناريو: ترى أن هدفًا ما يحتاج إلى دفع فوري وتريد بدءه من المحادثة الجارية نفسها. الطريقة: اطلب من AgentWorks تنفيذ start runs. النتيجة المتوقعة: يبدأ التشغيل وتتولى تنفيذه واجهات CLIs لوكلاء البرمجة المثبتة لديك (Claude Code وCodex وCursor وPi وMuse). انتبه: هذا ليس استعلامًا بل فعل يعمل عملًا حقيقيًا — يستمر التشغيل في العمل حتى بلوغ المؤشر. تأكد قبل البدء من سلامة إعداد الهدف والنطاق؛ ونقاط التأكيد البشري على مستوى التشغيل غير موثقة رسميًا.
حدود الاستخدام
طبيعة القراءة والكتابة: القدرات التي يكشفها MCP تشمل القراءة (فحص الأهداف، قراءة التقارير) والتنفيذ (بدء التشغيلات) معًا. بدء تشغيل يجعل الوكيل يعمل حتى بلوغ مؤشر الهدف، بأثر جانبي حقيقي؛ ولم تُوسم الأدوات رسميًا بمؤشر «للقراءة فقط»، فلا تفترض أن كلها كذلك.
بيانات الاعتماد والبيانات المحلية: يتطلب التشغيل الأول اختيار مجلد مساحة عمل محلي؛ ويُستخدم AUTH_SECRET لتشفير مفاتيح المزودين، ويجب أن تعيد مساحة العمل نفسها القيمة نفسها على كل جهاز. أما كيفية إعداد مفاتيح المزودين فلم تتوسع الصفحة الرسمية في شرحها.
الآثار الجانبية ونقاط التأكيد: يكتب سكربت التثبيت في /Applications و~/go/bin، ويزيل علامة الحجر الصحي في macOS، ويشغّل التطبيق؛ وبعد بدء التشغيل يواصل الوكيل التنفيذ، ولم يُعثر في الشرح الرسمي على آلية تأكيد خطوة بخطوة.
القيود الصريحة والمجهولات: مسار التثبيت لا يرد وصفه إلا لـ macOS؛ وطبيعة المنصة متاحة المصدر (source-available) — ويعنون المستودع نفسه أيضًا بـ Open source — وشروط الترخيص مرجعها المستودع؛ ودعم الأنظمة غير macOS، والقائمة الكاملة لأدوات MCP ومعاملاتها، وأشكال الاستضافة البعيدة، وأساليب المصادقة غير AUTH_SECRET، كلها غير موثقة، فيُنصح بالتحقق من المستودع الرسمي قبل الاستخدام.