מעבר מ-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 ל-IDE — המדריך הזה מסביר איך לעבור בערב אחד בלי לשבור דבר.

מה בדיוק יפסיק לעבוד ב-18 ביוני 2026?#

זו אינה "סגירה מוחלטת של הפרויקט", אלא הפסקת שירות עבור שלוש התוכניות הפופולריות ביותר. מי יושפע:

מתוך הבלוג הרשמי של Google Developers:

אם השתמשתם בתוכנית Free, כמו רוב המפתחים העצמאיים, ואתם חושבים "אבל יש לי חשבון בתשלום" — בדקו בדיוק איך מחויב מפתח ה-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 וכו'); התחביר כמעט לא השתנה.
• סוכני משנה — פועלים כבעבר, והתצורה שלהם מועברת אוטומטית.
• הרחבות — שינו את שמן לתוספי Antigravity, ומייבאים אותן בפקודה אחת.

מה לא עבר בצורה חלקה: שרתי MCP וסקריפטים ישנים שניגשים ישירות אל .gemini/config.json. לפי הדיון ב-GitHub, יש משתמשים שמדווחים שתצורות MCP מתקלקלות וצריך לכתוב אותן מחדש ידנית. יש על כך סעיף נפרד בהמשך.

Google אינה סוגרת את פרויקט הקוד הפתוח Gemini CLI:

כלומר, אפשר ליצור ממנו fork ולהמשיך להשתמש בו עם מפתח 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, הבעיה קשורה לאזור שלכם או ל-proxy.

אימות זהות

בפעם הראשונה שמריצים את 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 וסוכני משנה פעילים. השוו זאת לרשימה שהייתה לכם ב-Gemini CLI — לא אמורים להיות פריטים חסרים.

4. agy config --edit

   פותח את התצורה בעורך ברירת המחדל ($EDITOR). אם משהו לא זוהה אוטומטית, ערכו אותו ידנית.

5. agy doctor

   בדיקה סופית: בינארי, אימות, תוספים ורשת. אם כל ארבעת הפריטים מסומנים בירוק, העברת התצורה הושלמה.

מומלץ להשאיר את התיקייה הישנה .gemini/ כגיבוי למשך חודש, למקרה שמשהו התפספס. לאחר שבוע של שימוש ב-Antigravity, וכשוידאתם שהכול נמצא שם, אפשר למחוק אותה.

אם אתם עובדים עם AGENTS.md כתצורה אוניברסלית לכל כלי ה-AI, אין צורך לגעת בו. Antigravity CLI קורא את AGENTS.md מאותה תיקייה כמו Claude Code או Codex.

אילו משתני סביבה צריך לשנות?#

טבלת החלפה מלאה:

אם יש לכם GitHub Actions שמעבירים secrets, פתחו את Settings -> Secrets -> Actions ושנו את שמות המפתחות. הערכים עצמם נשארים זהים (מפתח ה-API של Google לא השתנה במהלך המעבר).

בדקו את כל המקומות שבהם עשויה להופיע GEMINI_:

# Find mentions throughout the project
grep -rn "GEMINI_" . --include="*.yml" --include="*.yaml" --include="*.sh" --include=".env*" 2>/dev/null

# In dotfiles
grep -nE "GEMINI_" ~/.zshrc ~/.bashrc ~/.bash_profile ~/.config/fish/config.fish 2>/dev/null

לאחר ההחלפה, הפעילו מחדש את המסוף ובדקו נוכחות בלי להדפיס את הסוד. אל תפעילו מעקב פקודות shell ואל תעתיקו ערכי מפתחות ליומנים. נוכחות לבדה אינה מוכיחה הרשאה; בדקו בנפרד את 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        # should show “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. תוסף IDE. תוסף Gemini Code Assist ל-VS Code יושבת יחד עם ה-CLI. החלופה היא Antigravity IDE (מזלג נפרד של VS Code) או AGENTS.md בכל עורך AI אחר.

5. טעינה באמצעות @[file]. בגרסאות מוקדמות של Antigravity CLI היו באגים בפקודת @src/file.ts לטעינת קובץ להקשר. עדכנו לגרסה האחרונה: agy update.

אם משהו קריטי מתקלקל ולא ניתן לתקן אותו בתוך שעה, פתרון זמני לתוכנית Free הוא להמשיך להשתמש ב-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

   שנו את שם הפקודה ואת שמות ה-secrets מ-GEMINI_* ל-AV_*.

9. השארת .gemini/ כגיבוי

   אפשר למחוק אותה 1–2 שבועות אחרי שמוודאים שהכול עובד.

ולבסוף: 18 ביוני לא אומר ש"כל הפרויקטים שלכם ייפלו". פירוש הדבר הוא שהערוץ החינמי יושבת. הגישה בתשלום ל-Cloud API תישאר, מאגר Gemini CLI יישאר ויהיה אפשר ליצור forks. אם השתמשתם בתוכנית Free, עליכם להחליט לפני 18 ביוני; אחרת, פקודת gemini "something" הבאה תחזיר שגיאת הרשאה.