codeagent-mobile-clients

CodeAgent Mobile — Clients هو المستودع العام لجسور جانب العميل لـ CodeAgent Mobile، وهي طبقة استمرارية سير عمل تتيح لك الإشراف على وكلاء البرمجة بالذكاء الاصطناعي (Claude Code و Copilot و Cursor و Windsurf و JetBrains AI و OpenAI Codex و Vertex AI إلخ) من جهاز محمول أو لوحة تحكم ويب. يحتوي المستودع على ثلاثة عملاء منفصلين: - **apps/cli** – `codeam-cli`، وهو جسر طرفي يغلف Claude Code في PTY ويرسل الأوامر إلى أي جهاز. يمكن تثبيته عبر npm ويُستخدم مع تدفق إقران عبر رمز الاستجابة السريعة (QR). - **apps/vsc-plugin** – امتداد لـ VS Code و Cursor و Windsurf يتصل بنفس مرحل الخلفية، مما يسمح لك بالموافقة على الفروقات، وإعادة توجيه الموجهات، ومراقبة الجلسات من هاتفك. - **apps/jetbrains-plugin** – امتداد لعائلة IntelliJ (IDEA و WebStorm و PyCharm و Rider و GoLand ...) يدمج نفس قدرات التحكم عبر الهاتف المحمول. يشارك جميع العملاء نفس تكوين متغيرات البيئة (`CODEAM_API_URL` و `CODEAM_TEST_MODE=1`) لتوجيههم إلى واجهة برمجة تطبيقات الإنتاج أو مرحلة الاختبار أو المستضافة ذاتياً. يقرأون هذه المتغيرات من عملية المضيف؛ كما تدعم امتدادات VS Code و JetBrains إعداد `apiBaseUrl` كتجاوز يدوي. يتبع تصميم المستودع نمط المستودع الأحادي (monorepo) مع مجلد `apps/` لكل عميل، وحزمة TypeScript مشتركة في `packages/shared` تحتوي على محلل بروتوكول الكتل وجداول أسعار النماذج (المضمنة في وقت البناء)، ونصوص جذرية لعمليات البناء والاختبار والنشر. متطلبات البناء المسبق هي Node الإصدار 18 أو أحدث، و Python 3 (للتعامل مع PTY)، و JDK 17 لامتداد JetBrains. يتم تنسيق الإصدارات عبر خط إصدار واحد (يبدأ من 2.0.0). يؤدي وضع علامة `vX.Y.Z` إلى نشر تلقائي لـ CLI إلى npm، وامتداد VS Code إلى كل من سوق VS Code و Open VSX، وامتداد JetBrains إلى القناة المستقرة لسوق JetBrains. تتخطى علامات الإصدارات المسبقة دفع امتداد JetBrains إلى السوق. من الناحية المعمارية، يعمل العملاء كمرحلات رفيعة: يتصلون بالخلفية الخاصة بـ CodeAgent عبر REST/WebSocket، ويعيدون توجيه الأوامر إلى وكيل الذكاء الاصطناعي المحلي (عبر PTY أو واجهات برمجة تطبيقات IDE أو الطرفية)، ويرسلون الجلسة إلى واجهة المستخدم للهاتف المحمول/الويب للموافقة عليها، وإعادة توجيهها، والإشراف غير المتزامن. تتبع عملية المساهمة سير عمل بسيط: افتح مشكلة (issue) للتعديلات غير البسيطة، وحصر التعديلات لكل تطبيق على حدة، وقم بتشغيل الاختبارات المناسبة (`npm run test:cli`) وتأكد من نجاح عمليات البناء قبل تقديم طلب سحب (pull request). المشروع مرخص بموجب رخصة MIT. هذا المستودع مثالي للمطورين الذين يريدون توسيع سير عمل البرمجة بالذكاء الاصطناعي لما بعد سطح المكتب، حيث يوفر مستوى تحكم موحد لعدة بيئات تطوير متكاملة (IDEs) ووكلاء طرفية من واجهة تحكم واحدة للهاتف المحمول.