الانتقال من Gemini CLI إلى Antigravity CLI: دليل

في 19 مايو 2026، أعلنت Google أنها ستوقف Gemini CLI القديم لجميع باقات Free وPro وUltra في 18 يونيو. بعد أسبوعين من نشر هذا الدليل، سيتوقف الأمر gemini عن معالجة الطلبات. الانتقال من Gemini CLI إلى Antigravity CLI باستخدام الأمر agy هو الطريقة الوحيدة لمواصلة استخدام أدوات Google. أُنشئ agy بلغة Go، ويبدأ أسرع بعشرات المرات.

إذا كان لديك أي شيء يعمل على Gemini CLI—مثل نصوص CI البرمجية، أو مهام cron الليلية، أو إضافة Gemini Code Assist لبيئة التطوير المتكاملة—فهذا الدليل يشرح كيفية الانتقال في أمسية واحدة من دون تعطيل أي شيء.

ما الذي سيتوقف عن العمل تحديدًا في 18 يونيو 2026؟#

هذا ليس «إغلاقًا كاملًا للمشروع»، بل إيقاف للباقات الثلاث الأكثر شيوعًا. المتأثرون هم:

من مدونة Google Developers الرسمية:

إذا كنت تستخدم الباقة المجانية، مثل معظم المطورين الأفراد، وتفكر «لكن لدي حسابًا مدفوعًا»، فتحقق بدقة من طريقة احتساب تكلفة مفتاح API لديك. فـAI Pro ليس فوترة عبر Cloud؛ بل هو اشتراك شخصي في Google AI، وسيُعطَّل. أما الفوترة عبر Cloud باستخدام مشروع مدفوع فلن تُعطَّل.

لماذا تغلق Google Gemini CLI أصلًا؟#

كان gemini القديم يبدأ في «مئات المللي ثانية» لأن Node.js كان يحتاج إلى وقت للاستعداد. أما agy الجديد فهو ملف Go ثنائي ثابت ومستقل، ويبدأ في «أجزاء من الثانية». والفرق كبير في CI والنصوص البرمجية التي تستدعي CLI مئات المرات في كل تشغيل.

ما تقوله Google عن السرعة والسبب:

انتقلت جميع الميزات الرئيسية في Gemini CLI:

• Agent Skills — أصبح مجلد .gemini/skills/ موجودًا الآن في .agents/skills/.
• Hooks — الأحداث نفسها (PreToolUse وPostToolUse وغيرها)، ولم تتغير الصياغة إلا قليلًا.
• Subagents — تعمل كما كانت من قبل، ويُرحَّل إعدادها تلقائيًا.
• الإضافات — أُعيدت تسميتها إلى إضافات Antigravity ويمكن استيرادها بأمر واحد.

ما لم ينتقل بسلاسة: خوادم MCP والنصوص البرمجية القديمة التي تصل مباشرةً إلى .gemini/config.json. وفقًا للنقاش على GitHub، أفاد بعض المستخدمين بتعطل إعدادات MCP وضرورة إعادة كتابتها يدويًا. ستجد قسمًا منفصلًا عن ذلك أدناه.

لا تغلق Google مشروع Gemini CLI مفتوح المصدر:

هذا يعني أنه بإمكانك إنشاء نسخة متفرعة منه ومواصلة استخدامه باستخدام مفتاح Gemini API الخاص بك. لكن هذا أصبح الآن إعدادًا مدفوعًا عبر فوترة Cloud؛ فقد انتهى ترتيب Code Assist المجاني.

كيفية تثبيت Antigravity CLI: أوامر macOS وLinux وWindows#

قبل البدء، أجرِ فحصًا سريعًا: ما الباقة التي تستخدمها؟ إذا كان لديك مشروع Cloud مدفوع ولا ينطبق عليك الموعد النهائي في 18 يونيو، فالانتقال مفيد لكنه ليس عاجلًا. أما إذا كنت تستخدم Free/Pro/Ultra ولديك شيء يعمل على CLI، فانتقل الآن، ما دامت الباقات نشطة، كي تتمكن من مقارنة السلوك في المهمة نفسها.

macOS وLinux

أمر من سطر واحد باستخدام curl:

curl -fsSL https://antigravity.google/cli/install.sh | bash

يكتشف النص البرمجي المنصة، وينزّل الملف الثنائي agy، ويتحقق من مجموع التحقق الخاص به، ثم يضعه في ~/.local/bin. إذا لم يكن هذا المجلد ضمن PATH، فأضفه:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

تحقق من ظهور الملف الثنائي:

which agy
agy --version

Windows (PowerShell)

irm https://antigravity.google/cli/install.ps1 | iex

سيُثبَّت الملف الثنائي في C:\Users\[your_name]\AppData\Local\agy\bin. سيحدّث المُثبّت PATH تلقائيًا، لكن افتح نافذة PowerShell جديدة لإعادة تحميل المتغيرات.

Windows (CMD)

إذا كانت سياسة شركتك تحظر PowerShell:

curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd

التحقق من التثبيت

بعد التثبيت على أي نظام تشغيل، شغّل:

agy doctor

يتحقق الأمر من إصدار الملف الثنائي، ووجود إعدادات، والمصادقة، والوصول إلى الشبكة على antigravity.google. إذا تعذر عليه الوصول إلى Google، فالمشكلة في منطقتك أو في الوكيل.

المصادقة

في المرة الأولى التي تشغّل فيها agy من دون وسيطات، يبدأ معالج الإعداد:

1. اختر سمة الواجهة.
2. اختر طريقة المصادقة: Google OAuth (للحسابات الشخصية) أو مفتاح API.
3. يمكنك اختياريًا استيراد الإعدادات من .gemini/ على الفور.

إذا اخترت OAuth، فسيُفتح متصفح ويعيد توجيهك إلى accounts.google.com؛ وستحتاج إلى الموافقة على مشاركة البيانات. بعد ذلك، ستعمل CLI.

كيفية ترحيل الإعدادات والإضافات من .gemini إلى .agents#

خطوة بخطوة:

1. agy plugin import gemini

   شغّل الأمر من أي مجلد. سيُرحّل الإضافات العامة من ~/.gemini/ إلى ~/.agents/. أما إضافات مساحة العمل (الموجودة بجوار المشروع)، فشغّل الأمر من داخل مجلد المشروع.

2. mv .gemini/skills/ .agents/skills/

   انقل المهارات بإعادة تسمية المجلد يدويًا. تنسيق الملفات الموجودة بداخله هو نفسه؛ ولا حاجة إلى إعادة كتابة Markdown.

3. agy inspect

   يعرض الإضافات والمهارات وhooks وsubagents النشطة. قارنها بالقائمة التي كانت لديك في Gemini CLI—ولا ينبغي أن ينقصها شيء.

4. agy config --edit

   يفتح الإعدادات في المحرر الافتراضي ($EDITOR). إذا لم يتم استيراد شيء تلقائيًا، فعدّله يدويًا.

5. agy doctor

   الفحص النهائي: الملف الثنائي، والمصادقة، والإضافات، والشبكة. إذا كانت العناصر الأربعة كلها سليمة، فقد اكتمل ترحيل الإعدادات.

أُبقي المجلد القديم .gemini/ في مكانه شهرًا بوصفه نسخة احتياطية، تحسبًا لفوات شيء. بعد استخدام Antigravity لمدة أسبوع والتأكد من وجود كل شيء، يمكنك حذفه.

إذا كنت تستخدم AGENTS.md بوصفه إعدادًا موحدًا لجميع أدوات الذكاء الاصطناعي، فلا حاجة إلى تعديله. يقرأ Antigravity CLI ملف AGENTS.md من المجلد نفسه الذي يوجد فيه Claude Code أو Codex.

ما متغيرات البيئة التي يجب تغييرها؟#

جدول الاستبدال الكامل:

إذا كانت لديك GitHub Actions تمرر أسرارًا، فافتح Settings -> Secrets -> Actions وأعد تسمية المفاتيح. تظل القيم كما هي (لم يتغير مفتاح Google API أثناء الانتقال).

تحقق من جميع الأماكن التي قد تحتوي على GEMINI_:

# اعثر على الإشارات في أنحاء المشروع
grep -rn "GEMINI_" . --include="*.yml" --include="*.yaml" --include="*.sh" --include=".env*" 2>/dev/null

# في ملفات dotfiles
grep -nE "GEMINI_" ~/.zshrc ~/.bashrc ~/.bash_profile ~/.config/fish/config.fish 2>/dev/null

بعد استبدالها، أعد تشغيل الطرفية وتحقق من وجود المتغير دون طباعة السر. لا تفعّل تتبع أوامر الصدفة ولا تنسخ قيم المفاتيح إلى السجلات. وجود القيمة وحده لا يثبت صحة التفويض؛ افحص agy doctor بصورة مستقلة:

if [ -n "${AV_API_KEY:-}" ]; then
    printf 'AV_API_KEY is set\n'
else
    printf 'AV_API_KEY is missing or empty\n'
fi
agy doctor        # ينبغي أن يعرض “authorized”

أكثر ما يتعطل أثناء الانتقال وكيفية إصلاحه#

قائمة بالمشكلات الأولية:

1. خوادم MCP. إذا كنت تستخدم mcp_servers في .gemini/config.json، فقد لا تُستورد بعد agy plugin import gemini. تحقق باستخدام agy inspect—سيظهر قسم mcp. إذا كان فارغًا أو يحتوي على أخطاء، فأعد كتابته يدويًا باستخدام agy config --edit. يرد وصف التنسيق في وثائق Antigravity الرسمية (ابحث عن قسم MCP).

2. Hooks مخصصة. إذا كان لديك نص bash برمجي في .gemini/hooks/ يقرأ $GEMINI_API_KEY، فسيتعطل. اعثر على هذه المواضع: bash

   grep -rn "GEMINI_" .agents/hooks/ 2>/dev/null
   

   استبدل المتغيرات.

3. CI/CD. في GitHub Actions أو GitLab CI، غيّر الخطوات التي تستخدم الأمر gemini لتستخدم agy. قد يختلف اسم الملف الثنائي في المُثبّت، لذا أنشئ طبقة تجريد باستخدام المتغير $CLI_CMD.

4. إضافة بيئة التطوير المتكاملة. ستُعطَّل إضافة Gemini Code Assist لـVS Code مع CLI. البديل هو Antigravity IDE (نسخة متفرعة مستقلة من VS Code) أو AGENTS.md في أي محرر آخر للذكاء الاصطناعي.

5. تحميل @[file]. احتوت الإصدارات الأولى من Antigravity CLI على أخطاء في الأمر @src/file.ts المستخدم لتحميل ملف إلى السياق. حدّث إلى أحدث إصدار: agy update.

إذا تعطّل شيء أساسي وتعذّر إصلاحه خلال ساعة، فالحل المؤقت لمستخدمي الباقة المجانية هو البقاء على Gemini CLI حتى 18 يونيو، مع إعداد الانتقال على فرع منفصل من المستودع. الحد الزمني: 14 يومًا.

هل يستحق الأمر الاستمرار في استخدام أدوات Google بعد 18 يونيو؟#

يمكن اعتبار Antigravity 2.0 خيارًا احتياطيًا عندما لا تكون أداتك الرئيسية (Claude Code أو Codex) مناسبة. للاطلاع على تفاصيل نقاط قوته وضعفه، راجع دليل Google Antigravity 2.0.

ملخص سريع لما ينبغي فعله حسب وضعك:

قائمة التحقق للانتقال في 15 دقيقة#

1. تثبيت Antigravity CLI

   curl -fsSL https://antigravity.google/cli/install.sh | bash (macOS/Linux) أو irm https://antigravity.google/cli/install.ps1 | iex (Windows PowerShell).

2. بدء agy والمصادقة

   شغّل agy من دون وسيطات. اختر OAuth أو مفتاح API.

3. استيراد الإضافات من .gemini

   ينقل agy plugin import gemini الإضافات على المستوى العام. شغّله مجددًا من داخل مجلد المشروع لإضافات مساحة العمل.

4. نقل المهارات

   mv .gemini/skills/ .agents/skills/. تبقى محتويات الملفات كما هي.

5. استبدال متغيرات البيئة

   في ~/.zshrc/~/.bashrc وملفات .env: GEMINI_API_KEY → AV_API_KEY، وGEMINI_PROJECT_ID → AV_PROJECT_ID، وGEMINI_REGION → AV_REGION. أعد تشغيل الطرفية.

6. التحقق من التثبيت

   agy doctor—يجب أن تكون العناصر الأربعة (الملف الثنائي، والمصادقة، والإضافات، والشبكة) سليمة.

7. تشغيل مهمة اختبار

   agy "write a README for the project in the current folder"—تحقق من أن النتيجة مشابهة لما أنتجه Gemini CLI.

8. تحديث GitHub Actions / GitLab CI

   غيّر اسم الأمر والأسرار من GEMINI_* إلى AV_*.

9. الاحتفاظ بـ .gemini/ كنسخة احتياطية

   يمكنك حذفه بعد أسبوع أو أسبوعين من التأكد من أن كل شيء يعمل.

وأخيرًا: لا يعني 18 يونيو أن «جميع مشاريعك ستتوقف». بل يعني تعطيل القناة المجانية. وسيظل الوصول المدفوع إلى Cloud API متاحًا، وسيبقى مستودع Gemini CLI قائمًا، وتظل النسخ المتفرعة ممكنة. إذا كنت تستخدم الباقة المجانية، فعليك اتخاذ قرار قبل 18 يونيو؛ وإلا فسيُرجع الأمر التالي gemini "something" خطأً في التفويض.