إذا كنت تستخدم الطرفية (Terminal) بشكل يومي، فأنت تعرف كم من الوقت يضيع في كتابة أوامر طويلة مثل grep -r 'error' *.log | awk '{print $1}'. Vibe Zsh هو إضافة (plugin) لـ Zsh تهدف إلى حل هذه المشكلة: بدلاً من كتابة الأمر، تكتب جملة طبيعية (أو تستخدم الإملاء الصوتي) وتضغط Ctrl+G لتحصل على الأمر المنفذ.

ظهر المشروع على Hacker News كـ Show HN، مما يعني أن مجتمعاً تقنياً قوياً يهتم به. لكن README الخاص به مختصر جداً، لذا سنقدم لك دليلاً عملياً للتركيب والتشغيل، مع أمثلة بالعربية والإنجليزية، وتوضيح للأخطاء الشائعة.

ما هو Vibe Zsh؟

Vibe Zsh هو إضافة (plugin) لـ Zsh تسمح لك بكتابة جملة طبيعية (مثل 'show me all files larger than 1MB') وتحويلها إلى أمر شل منفذ. الفكرة تشبه GitHub Copilot للطرفية، لكنها مجانية ومفتوحة المصدر. يعتمد على API خارجي (غالباً OpenAI) لتحليل النص.

لمن هذا المشروع؟ ومن لا يحتاجه؟

يناسب: المطورين الذين يستخدمون Zsh ويريدون تسريع كتابة الأوامر المعقدة، خاصة من لا يحفظون syntax awk/sed/grep. أيضاً مناسب لمن يستخدمون الإملاء الصوتي (dictation) لتقليل الكتابة.

لا يناسب: من يفضل التحكم الكامل بكل أمر، أو من يعمل في بيئة حساسة لا تسمح بإرسال البيانات لخادم خارجي، أو من لا يستخدم Zsh.

المميزات الرئيسية

• تحويل اللغة الطبيعية إلى أوامر شل مباشرة
• يدعم الإملاء الصوتي عبر أدوات خارجية (مثل macOS dictation)
• مفتوح المصدر ومجاني (عدا تكلفة API)
• خفيف وسهل التركيب (git clone + source)

المتطلبات الأساسية قبل التركيب

• نظام تشغيل: Linux أو macOS (لم يذكر دعم Windows)
• Zsh shell (معظم التوزيعات الحديثة مثبت افتراضياً)
• مفتاح API من OpenAI (أو مزود مشابه) – ضروري للتشغيل
• اتصال بالإنترنت (لأن API خارجي)

تركيب Vibe Zsh خطوة بخطوة

تنبيه: README المشروع غير واضح، لذا الخطوات التالية تقريبية بناءً على بنية المشروع. قد تختلف حسب إصدارك.

1. افتح الطرفية وانتقل إلى مجلد الإضافات (مثلاً ~/.zsh/plugins):
   mkdir -p ~/.zsh/plugins && cd ~/.zsh/plugins
2. استنسخ المستودع:
   git clone https://github.com/skymoore/vibe-zsh.git
3. أضف السطر التالي إلى ملف ~/.zshrc:
   source ~/.zsh/plugins/vibe-zsh/vibe-zsh.plugin.zsh
4. أعد تحميل Zsh:
   source ~/.zshrc
5. قم بإعداد مفتاح API (انظر القسم التالي).

شرح ملف .env وإعدادات API

تحتاج إلى تعيين متغير بيئة يحتوي على مفتاح API. README لم يذكر اسم المتغير، لكن عادة يكون OPENAI_API_KEY. أضف السطر التالي إلى ~/.zshrc:

export OPENAI_API_KEY='your-api-key-here'

يمكنك الحصول على مفتاح من OpenAI. إذا كنت تستخدم مزوداً آخر، قد يختلف اسم المتغير.

كيفية تشغيل Vibe Zsh واستخدامه

بعد التركيب، اكتب جملة طبيعية في الطرفية ثم اضغط Ctrl+G. مثال:

• اكتب list all files in this directory ثم Ctrl+G → يتحول إلى ls -la
• اكتب find all text files containing the word error ثم Ctrl+G → يتحول إلى grep -r 'error' *.txt
• اكتب delete all temporary files ثم Ctrl+G → يتحول إلى rm -rf *.tmp

إذا كنت تستخدم الإملاء الصوتي (مثل ميزة Dictation في macOS)، يمكنك التحدث بالجملة ثم الضغط على Ctrl+G.

أخطاء شائعة وحلولها

استخدامات عملية في السوق السعودي/الخليجي

• مطور سعودي يدير سيرفرات: يمكنه قول 'show me disk usage' بدلاً من كتابة df -h
• صاحب مشروع صغير: يمكنه أتمتة نسخ احتياطي بقوله 'backup all databases'
• صانع محتوى تقني: يمكنه شرح أوامر معقدة بطريقة مبسطة باستخدام الأداة

هل يستحق Vibe Zsh التجربة؟ تقييم موضوعي

الإيجابيات: فكرة مبتكرة، مجاني، خفيف، سهل التركيب نسبياً.

السلبيات: README غير كافٍ، يعتمد على API خارجي (تكلفة وخصوصية)، غير مستقر بعد، لا يدعم العربية صراحة (قد يعمل تجريبياً).

التقييم: مناسب للتجربة والاستخدام الشخصي، لكن لا تعتمد عليه في بيئة إنتاجية دون اختبار.

بدائل مشابهة

أسئلة شائعة (FAQ)

هل Vibe Zsh يدعم اللغة العربية؟

لم يذكر المشروع ذلك صراحة. قد يعمل تجريبياً مع النص العربي، لكن غير مضمون.

ما هي متطلبات النظام؟

Zsh على Linux أو macOS، اتصال إنترنت، مفتاح API.

هل يمكن استخدامه بدون إنترنت؟

لا، لأنه يعتمد على API خارجي.

ما الفرق بين Vibe Zsh وShellGPT؟

Vibe Zsh أخف وأبسط، لكن ShellGPT أكثر استقراراً ويدعم نماذج متعددة.

هل Vibe Zsh آمن؟

يرسل جملتك إلى API خارجي، لذا تجنب استخدامه مع بيانات حساسة.

كيف ألغي الأمر إذا أخطأ؟

قبل تنفيذ الأمر، يمكنك تعديله يدوياً أو الضغط على Ctrl+C للإلغاء.

هل يدعم الإدخال الصوتي المباشر؟

ليس مدمجاً، لكن يمكن استخدام أدوات الإملاء الصوتي في النظام.