CLI-Anything هو مكون إضافي مفتوح المصدر لوكلاء الترميز بالذكاء الاصطناعي (Claude Code بشكل أساسي) يقوم بإنشاء واجهة سطر أوامر كاملة لأي برنامج يمتلك قاعدة تعليمات برمجية. وجهه نحو GIMP أو Blender أو LibreOffice أو أي تطبيق آخر، وسيقوم بتحليل الكود المصدري وإنتاج واجهة سطر أوامر منظمة يمكن لوكيل الذكاء الاصطناعي الخاص بك استخدامها للتحكم في هذا البرنامج برمجياً.
المشكلة: وكلاء الذكاء الاصطناعي لا يستطيعون استخدام برامج الواجهة الرسومية
تنقسم حزمة البرمجيات اليوم إلى عالمين بالكاد يتواصلان مع بعضهما البعض.
على أحد الجانبين، لديك خدمات حديثة تركز على واجهة برمجة التطبيقات (API-first): التخزين السحابي، ومعالجات الدفع، وموفرو البريد الإلكتروني، ومنصات التحليلات. تتحدث هذه الخدمات بلغة HTTP. يمكن لوكيل الذكاء الاصطناعي استدعاؤها مباشرة دون الحاجة إلى أدوات خاصة.
على الجانب الآخر، لديك البرامج التي تعتمد عليها معظم سير العمل الاحترافية: GIMP لتحرير الصور، Blender للعمل ثلاثي الأبعاد، LibreOffice للمستندات، Audacity للصوت. لقد تم تصميم هذه البرامج ليقوم البشر بالنقر عليها. إنها تعرض واجهات رسومية، وليست واجهات برمجة تطبيقات منظمة.
عندما تحاول ربط وكيل ذكاء اصطناعي بهذه الفئة الثانية من البرامج، تكون الخيارات محدودة. يمكنك كتابة أغلفة مخصصة يدوياً، وهو ما يستغرق أسابيع ويتعطل عند تحديث البرنامج. يمكنك تجربة أدوات أتمتة العمليات الروبوتية (RPA)، التي تقوم بأتمتة تفاعلات الواجهة الرسومية عبر لقطات الشاشة والنقر على البكسلات. لكن RPA هش. يتعطل عندما تتغير تخطيطات النوافذ، وعندما تتحدث السمات، وعندما تتحول مقاييس العرض.
يتخذ CLI-Anything منهجاً مختلفاً: بدلاً من محاكاة إنسان ينقر عبر القوائم، فإنه يحلل الكود المصدري للبرنامج للعثور على واجهات برمجة التطبيقات الأساسية التي تستدعيها الواجهة الرسومية بالفعل. ثم يقوم بإنشاء واجهة سطر أوامر حقيقية تستدعي واجهات برمجة التطبيقات هذه مباشرة.
لا يحتاج وكيل الذكاء الاصطناعي الخاص بك إلى "رؤية" الشاشة. إنه يصدر أوامر منظمة. البرنامج يقوم بالعمل.
ما يفعله CLI-Anything
CLI-Anything هو مكون إضافي مفتوح المصدر تم بناؤه بواسطة HKUDS (مختبر علوم البيانات بجامعة هونغ كونغ). قال المنشئ، تشاو هوانغ، في إعلان المشروع:
"برامج اليوم تخدم البشر. مستخدمو الغد سيكونون وكلاء. CLI-Anything: سد الفجوة بين وكلاء الذكاء الاصطناعي وبرامج العالم. سطر أوامر واحد لجعل أي برنامج جاهزاً للوكلاء."
وقت كتابة هذا التقرير، تجاوز المشروع 6,100 نجمة على GitHub.
يعمل المكون الإضافي داخل Claude Code (وبشكل تجريبي في Codex و OpenCode). توجهه إلى قاعدة تعليمات برمجية لبرنامج ويقوم بتشغيل خط أنابيب آلي من 7 مراحل:
- تحليل - يقوم بمسح الكود المصدري، وربط إجراءات الواجهة الرسومية بواجهات برمجة التطبيقات الأساسية، وينتج وثيقة إجراءات تشغيل قياسية خاصة بالبرنامج.
- تصميم - يخطط لمجموعات الأوامر، ونماذج الحالة، وتنسيقات الإخراج.
- تنفيذ - يبني واجهة سطر أوامر (CLI) بايثون تستند إلى Click مع وضع REPL، ودعم إخراج
--json، وميزات التراجع/الإعادة. - تخطيط الاختبارات - ينشئ ملف
TEST.mdمع خطط اختبار الوحدات والاختبارات الشاملة (end-to-end). - كتابة الاختبارات - يكتب
test_core.py(اختبارات الوحدات ببيانات اصطناعية) وtest_full_e2e.py(اختبارات شاملة بملفات حقيقية). - توثيق - يقوم بتشغيل pytest ويلحق النتائج الكاملة بملف
TEST.md. - نشر - ينشئ
setup.py، ويقوم بتهيئة نقاط دخول سكربتات وحدة التحكم، ويثبتها في PATH.
بحلول نهاية المرحلة السابعة، سيكون لديك واجهة سطر أوامر عاملة مثبتة على نظامك. يمكن لوكيل الذكاء الاصطناعي الخاص بك اكتشافها باستخدام which cli-anything-gimp، وفحصها باستخدام cli-anything-gimp --help، والبدء في إصدار الأوامر.
تتبع جميع واجهات سطر الأوامر التي تم إنشاؤها تصميماً متسقاً: إخراج جدول قابل للقراءة بشرياً بشكل افتراضي، وإخراج JSON قابل للقراءة آلياً باستخدام علامة --json، وحالة مشروع مستمرة، وميزة التراجع/الإعادة، ووضع REPL تفاعلي. هذا الاتساق مهم: لا يحتاج وكيلك إلى تعلم واجهة مختلفة لكل أداة.
تثبيت CLI-Anything
CLI-Anything هو مكون إضافي يعتمد على بايثون. إنه ليس حزمة npm. تقوم بتثبيته في وكيل الترميز بالذكاء الاصطناعي الخاص بك، ويتم تثبيت واجهات سطر الأوامر التي تم إنشاؤها كحزم بايثون باستخدام pip install -e ..
المتطلبات:
- بايثون 3.10+
- البرنامج المستهدف مثبت على نظامك
- وكيل ترميز ذكاء اصطناعي مدعوم (Claude Code هو الأساسي؛ Codex و OpenCode تجريبيان)
Claude Code (الطريقة الأساسية)
/plugin marketplace add HKUDS/CLI-Anything
/plugin install cli-anything
يقوم هذا بتثبيت المكون الإضافي ويجعل أوامر الشرطة المائلة /cli-anything متاحة في جلسة Claude Code الخاصة بك.
OpenCode
استنسخ المستودع، ثم انسخ ملفات الأوامر و HARNESS.md إلى ~/.config/opencode/commands/. يضيف هذا خمسة أوامر شرطة مائلة: /cli-anything، /cli-anything-refine، /cli-anything-test، /cli-anything-validate، و /cli-anything-list.
Codex
bash CLI-Anything/codex-skill/scripts/install.sh
Qodercli
bash CLI-Anything/qoder-plugin/setup-qodercli.sh
ملاحظة حول ويندوز
يتطلب المكون الإضافي Git for Windows (الذي يتضمن bash و cygpath) أو WSL. لا يتم دعم واجهة أوامر ويندوز الأصلية. إذا رأيت cygpath: command not found، قم بتثبيت Git for Windows وحاول مرة أخرى.
تثبيت واجهة سطر الأوامر التي تم إنشاؤها
بعد أن يقوم المكون الإضافي بإنشاء واجهة سطر أوامر لبرنامجك، قم بتثبيتها إلى PATH الخاص بك:
cd <software>/agent-harness
pip install -e .
يستخدم هذا وضع التثبيت القابل للتعديل (-e)، مما يعني أن تغييراتك على الكود المصدري الذي تم إنشاؤه تستمر دون الحاجة إلى إعادة التثبيت.
إنشاء واجهة سطر الأوامر الأولى الخاصة بك
بمجرد تثبيت المكون الإضافي، يكون الإنشاء أمراً واحداً. إليك سير العمل لـ GIMP:
في Claude Code:
/cli-anything ./gimp
أو من مستودع GitHub:
/cli-anything https://github.com/blender/blender
يبدأ المكون الإضافي خط الأنابيب المكون من 7 مراحل. يستغرق هذا بضع دقائق اعتماداً على حجم قاعدة التعليمات البرمجية وعدد واجهات برمجة التطبيقات التي يكشفها البرنامج.
خلال المرحلة الأولى (التحليل)، يقرأ المكون الإضافي الكود المصدري وينشئ خريطة لإجراءات الواجهة الرسومية إلى استدعاءات واجهة برمجة التطبيقات الأساسية. بالنسبة لمحرر صور مثل GIMP، يعني هذا العثور على جميع الوظائف التي تنشئ الطبقات، وتطبق المرشحات، وتصدر الملفات، وتدير المشاريع. ينتج وثيقة SOP خاصة بالبرنامج (GIMP.md) تصف المجموعة الكاملة للعمليات.
خلال المرحلة الثالثة (التنفيذ)، يقوم ببناء واجهة سطر الأوامر باستخدام إطار عمل Click في بايثون. يدعم كل أمر إخراج --json. تخزن كل عملية ذات حالة (فتح ملف، إنشاء مشروع) الحالة في ملف JSON. تتضمن واجهة سطر الأوامر وضع REPL تفاعلي مع مطالبات ملونة وتاريخ مستمر.
يبدو هيكل الدليل الذي تم إنشاؤه كما يلي:
gimp/
agent-harness/
GIMP.md # وثيقة إجراءات التشغيل القياسية للبرنامج
setup.py
cli_anything/ # حزمة مساحة اسم (لا يوجد __init__.py - PEP 420)
gimp/
README.md
gimp_cli.py # نقطة دخول واجهة سطر الأوامر الرئيسية
core/ # وحدات المشروع والجلسة والتصدير
utils/ # واجهة REPL، أدوات مساعدة
tests/
test_core.py
test_full_e2e.py
TEST.md
تعيش جميع واجهات سطر الأوامر التي تم إنشاؤها ضمن مساحة الاسم cli_anything.* (على سبيل المثال، cli_anything.gimp). يمنع هذا تضارب الأسماء إذا قمت بإنشاء واجهات سطر أوامر لتطبيقات متعددة.
استخدام واجهة سطر الأوامر التي تم إنشاؤها
بعد تشغيل pip install -e . في دليل agent-harness، ستتوفر لديك واجهة سطر أوامر جديدة:
cli-anything-gimp --help
يعرض هذا جميع مجموعات الأوامر المتاحة وأوامرها الفرعية. التسمية متسقة: كل أداة تنشئ واجهة سطر أوامر باسم cli-anything-<software>.
الإخراج القابل للقراءة بشرياً (افتراضي)
# ابدأ مشروعاً جديداً
cli-anything-gimp project new --width 1920 --height 1080
# قائمة الطبقات
cli-anything-gimp layer list
# إضافة طبقة
cli-anything-gimp layer add --name "Background" --type solid --color "#ffffff"
# تطبيق مرشح
cli-anything-gimp filter apply --name "gaussian-blur" --radius 3
# تصدير
cli-anything-gimp export save --format png --output ./output.png
إخراج JSON لوكلاء الذكاء الاصطناعي
عندما يستدعي وكيل الذكاء الاصطناعي الخاص بك واجهة سطر الأوامر، فإنه يستخدم --json للحصول على إخراج قابل للقراءة آلياً:
cli-anything-gimp --json project new --width 1920 --height 1080
# يعود: {"status": "ok", "project_id": "proj_abc123", "width": 1920, "height": 1080}
cli-anything-gimp --json layer add -n "Background"
# يعود: {"status": "ok", "layer_id": "layer_001", "name": "Background"}
يتسم إخراج JSON بالاتساق عبر جميع الأوامر: status، وحقول خاصة بالعملية، وتفاصيل الخطأ عند حدوث مشكلة.
وضع REPL التفاعلي
للجلسات الممتدة، قم بتشغيل REPL:
cli-anything-gimp
يقوم هذا بإدخالك إلى واجهة أوامر تفاعلية مع مطالبات ملونة، وإكمال تلقائي بالضغط على Tab، وتاريخ مستمر. مفيد عندما تقوم ببناء سير عمل وترغب في تجربة الأوامر بشكل تفاعلي قبل كتابتها كسكريبت.
تراجع/إعادة
العمليات التي تعدل الحالة تدعم مكدس تراجع من 50 مستوى:
cli-anything-gimp undo
cli-anything-gimp redo
تحسين واختبار واجهة سطر الأوامر الخاصة بك
لا تكون واجهات سطر الأوامر التي تم إنشاؤها كاملة دائماً من أول مرة. يقوم الأمر /cli-anything:refine بتحليل الفجوات ويضيف الأوامر المفقودة.
تحسين عام
/cli-anything:refine /home/user/gimp
يقوم هذا بمسح واجهة سطر الأوامر الموجودة مقابل واجهة برمجة التطبيقات للبرنامج، ويحدد العمليات غير المشمولة، ويضيف أوامر جديدة للفجوات.
تحسين مركز
/cli-anything:refine /home/user/blender "particle systems and physics simulation"
عندما تعرف أي منطقة تحتاج إلى تغطية أكبر، قم بتمرير وصف للتركيز. يستهدف المكون الإضافي هذا الجزء من قاعدة التعليمات البرمجية بدلاً من إعادة تحليل كل شيء.
تشغيل الاختبارات
/cli-anything:test /home/user/gimp
يقوم هذا بتنفيذ مجموعات الاختبارات وتحديث ملف TEST.md بالنتائج. يفيد المشروع بوجود أكثر من 1,508 اختباراً ناجحاً عبر 11 تطبيقاً بمعدل نجاح 100%.
التحقق من الصحة
/cli-anything:validate /home/user/gimp
يتحقق من واجهة سطر الأوامر (CLI harness) مقابل مواصفات HARNESS.md للتأكد من أنها تفي بجميع المتطلبات الهيكلية.
سرد واجهات سطر الأوامر المتاحة
/cli-anything:list
/cli-anything:list --json # إخراج قابل للقراءة آلياً
/cli-anything:list --path /home # البحث في دليل محدد
حالات الاستخدام الواقعية
تم عرض CLI-Anything على 11 تطبيقاً. إليك كيفية ربط كل فئة بسير العمل الحقيقية.
خطوط أنابيب معالجة الصور باستخدام GIMP
يمكن لوكيل الذكاء الاصطناعي معالجة دفعة من صور المنتجات: تغيير الحجم إلى أبعاد قياسية، وتطبيق علامة مائية متسقة، والتصدير بتنسيقات متعددة. كل خطوة هي أمر واجهة سطر أوامر منظم. يمكن للوكيل التعامل مع مئات الصور دون أي تدخل بشري.
cli-anything-gimp project open --file product.jpg
cli-anything-gimp layer add --name "Watermark" --type image --source watermark.png
cli-anything-gimp layer position --name "Watermark" --x 10 --y 10
cli-anything-gimp export save --format webp --output product-final.webp
إنشاء المستندات باستخدام LibreOffice
يقوم LibreOffice بإنشاء ملفات PDF حقيقية. يمكن لوكيل إنشاء فواتير أو تقارير أو عقود من القوالب، وملء البيانات الديناميكية، والتصدير إلى PDF، كل ذلك من خلال سكربت.
cli-anything-libreoffice document open --template invoice-template.ods
cli-anything-libreoffice cell set --address "B5" --value "Acme Corp"
cli-anything-libreoffice cell set --address "C10" --value "1500.00"
cli-anything-libreoffice export pdf --output invoice-2026-001.pdf
العرض ثلاثي الأبعاد باستخدام Blender
يستغرق العرض في Blender وقتاً، لكنه قابل للبرمجة. يمكن لوكيل جدولة مهام العرض، وتكوين معلمات المشهد، وإدارة الإخراج دون الواجهة الرسومية:
cli-anything-blender scene open --file product-scene.blend
cli-anything-blender render set --samples 256 --output /renders/product
cli-anything-blender render start --format png
أتمتة البث باستخدام OBS Studio
OBS هي أداة بث. باستخدام CLI-Anything، يمكنك برمجة انتقالات المشهد، وإدارة المصادر، وعناصر التحكم في التسجيل:
cli-anything-obs scene set --name "Main Camera"
cli-anything-obs recording start
cli-anything-obs scene set --name "Screen Share"
cli-anything-obs recording stop --output session.mp4
تكامل CI/CD
يمكن لأي من هذه أن تتناسب مع خط أنابيب CI/CD. إجراء GitHub يقوم بإنشاء عرض Blender في كل عملية دفع، أو سير عمل يقوم بإنشاء ملاحظات إصدار PDF من قالب LibreOffice، كلاهما يصبحان بسيطين.
بناء سير عمل الوكيل باستخدام Apidog
يتعامل CLI-Anything مع البرامج المحلية. لكن معظم سير عمل الوكلاء الإنتاجية تحتاج أيضاً إلى استدعاء واجهات برمجة تطبيقات خارجية: تحميل الصورة المعالجة إلى شبكة توصيل المحتوى (CDN)، دفع ملف PDF الذي تم إنشاؤه إلى نظام إدارة المستندات، إرسال الفيديو المعروض إلى منصة مراجعة.
يتولى Apidog هذا الجانب. إنه عميل واجهة برمجة تطبيقات مجاني للاختبار والتوثيق وأتمتة استدعاءات واجهة برمجة تطبيقات REST.
إليك مثال ملموس: أنت تقوم ببناء وكيل يعالج صور المنتجات باستخدام GIMP ويقوم بتحميلها إلى واجهة برمجة تطبيقات تخزين سحابي. يوفر لك CLI-Anything أوامر GIMP. يتيح لك Apidog اختبار واجهة برمجة تطبيقات التخزين قبل أن تكتب أي كود تطبيق.
في Apidog، ستقوم بما يلي:
- إعداد بيئة مع بيانات اعتماد واجهة برمجة التطبيقات الخاصة بك المخزنة كمتغيرات
- اختبار نقطة نهاية التحميل بملف عينة لتأكيد تنسيق الطلب
- تشغيل التأكيدات على الاستجابة للتحقق من أن عنوان URL للملف يعود بشكل صحيح
- تصدير الطلب العامل كأمر curl أو مقتطف كود لإضافته إلى سكربت الوكيل الخاص بك
يوفر هذا دورة تصحيح الأخطاء حيث تكتب الكود، وتقوم بتشغيله، وتحصل على خطأ غامض، وتحاول معرفة ما إذا كانت المشكلة في أوامر GIMP الخاصة بك أو في استدعاء واجهة برمجة التطبيقات الخاصة بك. أنت تعلم أن واجهة برمجة التطبيقات تعمل قبل دمجها.
يدعم Apidog أيضاً مجموعات الاختبار الآلية. بمجرد أن يعمل سير عملك، يمكنك إضافة تأكيدات اختبار يتم تشغيلها في كل تنفيذ للكشف عن التراجعات.
القيود التي يجب معرفتها
يتطلب دعم Windows برنامج Git Bash أو WSL
واجهات سطر الأوامر التي تم إنشاؤها تعتمد على بايثون وتعتمد على معالجة المسارات بأسلوب bash. على نظام Windows، تحتاج إلى Git for Windows (الذي يتضمن bash و cygpath) أو WSL. لا يتم دعم PowerShell الأصلي.
يجب تثبيت البرنامج المستهدف
لا يقوم CLI-Anything بتجميع البرنامج الذي يلتف حوله. يجب تثبيت GIMP و Blender و LibreOffice والأدوات الأخرى على نفس الجهاز الذي تقوم بتشغيل واجهة سطر الأوامر التي تم إنشاؤها عليه. تستدعي واجهة سطر الأوامر الواجهات الخلفية للتطبيقات الحقيقية مباشرة.
إخراج بايثون فقط
جميع واجهات سطر الأوامر التي تم إنشاؤها هي تطبيقات Python Click. لا يوجد خيار لإنشاء واجهات سطر أوامر بلغات أخرى. إذا كانت سير عملك تتطلب غلاف CLI بلغة Node.js أو Go، فستحتاج إلى بنائه بشكل منفصل.
Claude Code هو المنصة المستقرة
Claude Code هو البيئة الأساسية والأكثر اختباراً. تم وضع علامة على تكامل Codex و OpenCode كـ تجريبي. قد تعمل الميزات بشكل غير متسق خارج Claude Code.
جودة الإنشاء تعتمد على قاعدة التعليمات البرمجية
يقوم المكون الإضافي بتحليل الكود المصدري للعثور على واجهات برمجة التطبيقات الكامنة وراء إجراءات الواجهة الرسومية. إذا كانت قاعدة التعليمات البرمجية سيئة التنظيم، أو معقدة للغاية، أو مرتبطة بإحكام بحالة الواجهة الرسومية، فقد يفشل التحليل في اكتشاف بعض الأوامر أو يولد أغلفة غير مكتملة. تساعد خطوة التحسين، ولكن البرامج الاحتكارية المعقدة قد يكون من الصعب تغليفها بشكل نظيف.
الأسئلة الشائعة
هل يعمل CLI-Anything مع أي برنامج؟
من حيث المبدأ، نعم. يمكنه إنشاء واجهة سطر أوامر لأي برنامج يمتلك قاعدة تعليمات برمجية يمكن الوصول إليها. عملياً، يعمل بشكل أفضل مع البرامج مفتوحة المصدر حيث يربط الكود المصدري بوضوح إجراءات الواجهة الرسومية باستدعاءات واجهة برمجة التطبيقات الأساسية. وقد أظهر المشروع ذلك على GIMP و Blender و Inkscape و Audacity و Kdenlive و Shotcut و OBS Studio و Draw.io و LibreOffice و AnyGen و Zoom.
هل المشروع مجاني للاستخدام؟
نعم. CLI-Anything مرخص تحت رخصة MIT ومفتوح المصدر بالكامل على github.com/HKUDS/CLI-Anything.
هل أحتاج إلى معرفة بايثون لاستخدامه؟
لا. لا تكتب أي كود بايثون. يقوم المكون الإضافي بإنشاء جميع أكواد بايثون. تحتاج فقط إلى تثبيت بايثون 3.10+ على نظامك لتشغيل واجهات سطر الأوامر التي تم إنشاؤها.
هل يمكنني استخدام واجهة سطر الأوامر التي تم إنشاؤها من الكود الخاص بي، وليس فقط من وكيل الذكاء الاصطناعي؟
نعم. واجهة سطر الأوامر التي تم إنشاؤها هي أداة سطر أوامر عادية. يمكنك استدعاءها من سكربتات shell، أو Makefiles، أو كود بايثون، أو أي شيء يمكنه تشغيل عملية فرعية.
ما هو ملف HARNESS.md؟
HARNESS.md هي وثيقة المواصفات التي تحدد كيف يجب أن يبدو حزام (harness) تم إنشاؤه بواسطة CLI-Anything. وهي تغطي بنية الأوامر، وتنسيقات الإخراج، ومتطلبات الاختبار، والتعبئة. تتحقق خطوة التحقق من صحة واجهة سطر الأوامر التي تم إنشاؤها مقابل هذه المواصفات.
هل يمكنني إنشاء واجهات سطر أوامر للأدوات الداخلية التي بنتها شركتي؟
نعم. وجه المكون الإضافي إلى أي قاعدة تعليمات برمجية على نظام ملفاتك، بما في ذلك الأدوات الداخلية الخاصة. يعمل المكون الإضافي محلياً ولا يرسل الكود المصدري الخاص بك إلى أي مكان.
كيف يقارن هذا ببروتوكول سياق النموذج (MCP)؟
يربط MCP وكلاء الذكاء الاصطناعي بالخدمات الخارجية عبر بروتوكول خادم موحد. يقوم CLI-Anything بإنشاء أغلفة واجهة سطر أوامر محلية لتطبيقات الواجهة الرسومية التي لا تحتوي على واجهات برمجة تطبيقات. إنهم يعالجون مشاكل مختلفة. قد تستخدم كلاهما: MCP للخدمات السحابية، و CLI-Anything لبرامج سطح المكتب.