إذا كنت مطوراً عربياً تبحث عن أداة AI برمجية تعمل في الطرفية وتدعم أكثر من مزود، فـ snow-cli هو ما تحتاجه. هذه الأداة تتيح لك التفاعل مع نماذج OpenAI وGemini وClaude مباشرة من سطر الأوامر، دون الحاجة إلى واجهة معقدة. في هذا الدليل، سنأخذك من الصفر إلى أول نتيجة عملية في أقل من 15 دقيقة.

لا تقلق إذا كنت جديداً في استخدام الطرفية أو لم تتعامل مع أدوات CLI من قبل. سنشرح كل خطوة بالتفصيل، مع أمثلة واقعية وأخطاء شائعة وحلولها. هدفنا أن تجرب الأداة بنفسك وتقرر إن كانت تناسب احتياجاتك.

ما هو snow-cli؟

snow-cli هو أداة طرفية (CLI) مفتوحة المصدر، مكتوبة بلغة TypeScript، تتيح لك استخدام نماذج AI متعددة (OpenAI، Gemini، Claude، Deepseek) لمساعدتك في مهام البرمجة. بدلاً من فتح متصفح والذهاب إلى ChatGPT، يمكنك البقاء في الطرفية والحصول على مساعدة فورية.

من يحتاج snow-cli ومن لا؟

يناسبك إذا:

• مطور مبتدئ أو متوسط تريد تجربة AI coding دون تعقيد.
• تعمل في الطرفية كثيراً وتريد مساعدة سريعة دون مغادرتها.
• تريد مرونة في اختيار مزود AI حسب المهمة (مثلاً Claude للتحليل، Gemini للسرعة).

لا يناسبك إذا:

• تريد أداة متكاملة مثل Copilot داخل محرر الأكواد.
• لا تملك اتصال إنترنت (الأداة تحتاج API).
• تبحث عن أداة مجانية بالكامل (استخدام API قد يكون مدفوعاً حسب المزود).

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

• يدعم OpenAI (GPT-4, GPT-3.5)، Gemini، Claude، Deepseek.
• تثبيت سريع عبر npm.
• خفيف وسريع، لا يستهلك موارد كثيرة.
• مفتوح المصدر (رخصة غير محددة، لكن الكود متاح).
• مجتمع نشط على Telegram وQQ.

المتطلبات الأساسية

• Node.js (الإصدار 14 أو أحدث). لتحميله: nodejs.org
• npm (يأتي مع Node.js).
• Git (اختياري، للاستنساخ من GitHub).
• مفاتيح API من مزود AI تختاره (OpenAI، Google AI، Anthropic).

تركيب snow-cli خطوة بخطوة

1. تثبيت Node.js وnpm: حمل من الموقع الرسمي واتبع التعليمات. تأكد من نجاح التثبيت بأمر node -v و npm -v.
2. تثبيت snow-cli عالمياً: افتح الطرفية (Terminal) واكتب:
   npm install -g snow-ai
   ملاحظة: قد تحتاج صلاحيات مدير (sudo على لينكس/ماك).
3. التحقق من التثبيت: اكتب snow --version، يجب أن يظهر رقم الإصدار.

إذا واجهت مشكلة في التثبيت العالمي، يمكنك استنساخ المستودع وتثبيته محلياً:

git clone https://GitHub.com/MayDay-wpf/snow-cli.git
cd snow-cli
npm install
npm link

إعداد ملف .env (مفاتيح API)

للاستخدام، تحتاج إلى تعيين مفتاح API لمزود واحد على الأقل. أنشئ ملفاً اسمه .env في المجلد الرئيسي للمشروع (أو في مجلد المستخدم) وأضف:

# اختر مزوداً واحداً على الأقل
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# أو
GEMINI_API_KEY=AIzaxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# أو
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

يمكنك أيضاً تعيين المتغيرات مباشرة في الطرفية (مؤقتاً):

export OPENAI_API_KEY=sk-xxx  # Linux/Mac
set OPENAI_API_KEY=sk-xxx   # Windows CMD

تشغيل snow-cli لأول مرة

بعد إعداد المفتاح، جرب أمراً بسيطاً:

snow "اكتب دالة JavaScript تجمع رقمين"

إذا ظهر رد، فالأداة تعمل. يمكنك تحديد المزود بوسيط --provider:

snow --provider gemini "اشرح هذا الكود: console.log('hello')"

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

استخدامات عملية (أمثلة)

مثال 1: إنشاء دالة JavaScript

snow "اكتب دالة تأخذ مصفوفة أرقام وتُرجع مجموعها"

النتيجة المتوقعة: كود JavaScript جاهز للنسخ.

مثال 2: كتابة سكريبت Bash

snow --provider claude "اكتب سكريبت Bash يحذف الملفات المؤقتة (.tmp) من المجلد الحالي"

مثال 3: شرح كود

snow --provider gemini "اشرح هذا الكود: const x = 5; console.log(x * 2);"

هل يستحق التجربة؟

نعم، خاصة إذا كنت تبحث عن أداة خفيفة ومجانية (باستثناء تكلفة API) تدعم نماذج متعددة. لكنها ليست بديلاً عن Copilot إذا كنت تريد تكاملاً عميقاً مع IDE. جربها لمدة أسبوع وقرر.

بدائل مشابهة

• aicommits: يولد رسائل commit باستخدام AI.
• shell_gpt: أداة CLI مشابهة تدعم GPT.
• Copilot CLI: من GitHub، لكنه مدفوع.

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

هل snow-cli مجاني؟

الأداة نفسها مجانية ومفتوحة المصدر، لكن استخدام API يتطلب اشتراكاً مدفوعاً لدى مزود AI (لكل مزود حد مجاني قد يكون كافياً للبدء).

ما هي نماذج AI المدعومة؟

OpenAI (GPT-4, GPT-3.5)، Gemini (Pro)، Claude (Sonnet, Haiku)، Deepseek.

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

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

ماذا أفعل إذا ظهر خطأ 'command not found'؟

تأكد من تثبيت snow-cli عالمياً (npm install -g snow-ai) أو استخدم npx snow.

كيف أحدث snow-cli إلى الإصدار الأحدث؟

أعد تشغيل أمر التثبيت: npm install -g snow-ai@latest.

هل snow-cli آمن لاستخدامه مع مشاريعي؟

نعم، لكن لا تشارك مفاتيح API. الأداة لا ترسل الكود المحلي لأي جهة غير مزود AI.

ما الفرق بين snow-cli وأدوات مثل Copilot؟

Copilot مدمج في IDE ويقترح كوداً أثناء الكتابة. snow-cli يعمل في الطرفية ويحتاج إلى أمر صريح.

هل يدعم snow-cli اللغة العربية؟

يدعم النصوص العربية كمدخلات ومخرجات، لكن الوثائق بالإنكليزية.