</> CodeAgents

ورقة مرجعية

Gemini CLI

وكيل برمجة Google بالذكاء الاصطناعي للطرفية

مزيد من التفاصيل

التثبيت والمصادقة

npm install -g @google/gemini-cliتثبيت Gemini CLI بشكل عام
geminiتشغيل وضع التفاعل التلقائي
gemini auth loginالمصادقة بحساب Google
GEMINI_API_KEY=...ضبط مفتاح API عبر متغير البيئة
gemini --versionعرض الإصدار المثبت

خيارات سطر الأوامر

--model gemini-3.1-pro-previewتحديد النموذج المستخدم
--all_filesتضمين جميع ملفات المستودع في السياق
--yoloتخطي جميع طلبات التأكيد
--sandboxتشغيل استدعاءات الأدوات في بيئة معزولة
--debugتفعيل سجلات التصحيح المفصّلة
--output_format jsonإخراج JSON للبرمجة النصية
--no-memoryتعطيل الذاكرة الدائمة للجلسة

أوامر REPL

/helpعرض قائمة الأوامر المتاحة
/clearمسح سجل المحادثة
/memory add <fact>حفظ معلومة في الذاكرة الدائمة
/memory showعرض جميع مدخلات الذاكرة المحفوظة
/memory clearحذف جميع مدخلات الذاكرة
/statsعرض إحصاءات استخدام الرموز
/compressضغط المحادثة لتوفير الرموز
/toolsعرض الأدوات المدمجة المتاحة
/quit or Ctrl+Cالخروج من Gemini CLI

الملفات والسياق

@filenameإرفاق ملف بالأمر
@folder/إرفاق مجلد بالكامل
gemini --all_filesتضمين جميع ملفات المستودع في السياق
GEMINI.mdملف تعليمات مستوى المشروع
~/.gemini/GEMINI.mdتعليمات مستوى المستخدم (عامة)
.geminiignoreاستبعاد ملفات من السياق (نمط gitignore)
1M token context windowقاعدة الكود بالكامل في طلب واحد

الأدوات المدمجة

read_fileقراءة محتويات ملف من القرص
write_fileكتابة أو إنشاء ملفات على القرص
run_commandتنفيذ أوامر shell
web_searchالبحث على الويب (تأريض Google Search)
web_fetchجلب وقراءة عنوان URL
list_directoryعرض محتويات مجلد
grepالبحث في محتويات الملفات بنمط

MCP والإعداد

mcpServers in settings.jsonضبط خوادم MCP
~/.gemini/settings.jsonملف الإعدادات على مستوى المستخدم
.gemini/settings.jsonملف الإعدادات على مستوى المشروع
sandbox: trueتفعيل وضع sandbox في الإعداد
GOOGLE_CLOUD_PROJECT=...ضبط متغير مشروع Vertex AI
Google Search groundingتفعيل الإجابات المستندة إلى الويب

code-agents.oday-bakkour.com · Gemini CLI · Last verified: April 2026