Миграция с Gemini CLI → Antigravity CLI

Google объявила 19 мая 2026 г. , что Gemini CLI переводится в Antigravity CLI. Для платных корпоративных клиентов ничего не изменится. Для всех пользователей аккаунтов Google AI Pro, Ultra или бесплатных индивидуальных аккаунтов Gemini Code Assist, Gemini CLI перестанет обрабатывать запросы 18 июня 2026 года. Это план миграции, который можно выполнить за один вечер, с возможностью rollback, если критически важный рабочий процесс нарушится.

1. Анонс

Два канала Google опубликовали новость о переходе в один и тот же день. Google Developers Blog представил график перехода. Аккаунт @geminicli в X подтвердил 30-дневное окно миграции для индивидуальных пользователей и сделал исключение для корпоративных клиентов (enterprise), которым не требуется совершать никаких действий.

Google DeepMind описал общую картину в отдельном официальном аккаунте — CLI является лишь одной из трех составляющих предложения для разработчиков, а не самостоятельным продуктом:

Официальная документация по миграции на antigravity.google/docs/gcli-migration является первоисточником для пофайлового сопоставления. Шаги ниже следуют документации по порядку, с разбором нюансов (gotchas) там, где они подразумеваются, но не описаны явно.

2. TL;DR

• Дедлайн: 18 июня 2026 года (индивидуальный уровень)
• Кого касается: Google AI Pro, Google AI Ultra, бесплатный Gemini Code Assist
• Не затронуты: Code Assist Standard / Enterprise, платные Gemini API ключи
• Замена: Antigravity CLI (бинарный файл: agy)
• Миграция одной командой: agy plugin import gemini
• Необходим ручной перенос: .gemini/skills/ → .agents/skills/, конфигурация MCP в mcp_config.json
• Переименование поля: remote MCP url → serverUrl
• Файлы контекста: GEMINI.md и AGENTS.md продолжают работать без изменений
• Параллельная установка: безопасно — gemini и agy сосуществуют
• Время чтения этого руководства: 14 минут; выполнение работы: около 45 минут

3. График

4. Кого это коснется

Пройдите эту быструю проверку, прежде чем читать дальше:

• Вы входите в Gemini CLI через личный аккаунт Google. Вас это коснется — это бесплатный / пользовательский сценарий.
• Вы оплачиваете подписку Google AI Pro или Google AI Ultra. Вас это коснется. Antigravity CLI использует ту же подписку.
• Вы используете Gemini Code Assist для частных лиц (бесплатный уровень). Вас это коснется. Работа Gemini CLI и расширения Code Assist для IDE прекратится 18 июня.
• Вы авторизуетесь в Gemini CLI с помощью платного Gemini API ключа. Вас это не коснется. Gemini CLI продолжит работу для пользователей платных API ключей.
• У вашей организации есть лицензия Gemini Code Assist Standard или Enterprise. Вас это не коснется. Доступ к Enterprise CLI остается без изменений.

5. Исключение для Enterprise

Согласно Google Developers Blog: “Если ваша организация использует Gemini CLI или наши расширения для IDE по лицензии Gemini Code Assist Standard или Enterprise, либо если ваша организация использует Gemini Code Assist для GitHub через Google Cloud, ваш доступ останется без изменений. Мы продолжим поддерживать Gemini CLI и Gemini Code Assist, предоставляя доступ к новейшим моделям Gemini и другим обновлениям.”

На практике у корпоративных клиентов остается три варианта:

• Оставить Gemini CLI на лицензии Standard / Enterprise — миграция не требуется.
• Оставить Gemini CLI с платным API ключом — миграция не требуется.
• Внедрить Antigravity CLI параллельно, используя учетные данные проекта GCP. Подробности о привязке проектов GCP см. на официальной странице для корпоративных клиентов.

Если вы корпоративный администратор и читаете это для кого-то другого, главный вывод для вас: планируйте пилотный запуск, не проводите экстренную миграцию всей организации. Установленный срок касается только пользовательского уровня.

6. Чек-лист перед началом

Перед началом миграции убедитесь, что:

• На вашей машине можно установить бинарный файл, распространяемый через Go (agy) — у вас есть доступ к curl, irm или права администратора в терминале.
• Вы знаете, какой аккаунт Google используется в Gemini CLI сейчас (миграция перенесет этот же аккаунт).
• Вы можете вывести список установленных расширений Gemini CLI (gemini extension list).
• Ваша ~/.gemini/ директория не повреждена (в ней хранятся ваши глобальные правила и навыки).
• Проекты Workspace с кастомными .gemini/ папками идентифицированы — для каждой требуется ручной перенос навыков уровня workspace.
• Если вы вызываете Gemini CLI через скрипты в CI или cron, подготовьте план перехода для смены имени бинарного файла (gemini → agy) и процесса аутентификации.

7. Шаг 1: Установите Antigravity CLI

По одной команде установки для каждой платформы из официального README:

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

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

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

После установки проверьте:

agy --version
# expected: a version string is printed

Бинарный файл называется agy, а не antigravity. Если вы используете CLI в скриптах, это и есть переименование. Бинарный файл Gemini CLI geminiостается на месте; они сосуществуют.

8. Шаг 2: Аутентификация

Первый запуск открывает процесс аутентификации. Два варианта:

• Локальный терминал. Выполните agy. Откроется ваш браузер по умолчанию. Войдите в тот же аккаунт Google, который вы использовали для Gemini CLI. Токен сохранится в системной связке ключей.
• Удаленное подключение / SSH. Выполните agy. CLI обнаружит SSH-сессию и выведет URL для авторизации. Откройте его на локальной машине, пройдите процесс OAuth, и SSH-сессия подхватит токен. Это было серьезной проблемой в ранних версиях Gemini CLI — теперь это нативная возможность.
• Enterprise. Во время настройки вы можете подключить проект GCP. Запросы будут тарифицироваться в рамках этого проекта. Подробности описаны в официальной документации для Enterprise.

9. Шаг 3: Импорт плагинов

On first launch, Antigravity CLI prompts to migrate Gemini CLI extensions to Antigravity plugins. If you skip the prompt or are installing on a fresh machine, run the import explicitly:

agy plugin import gemini

Пример вывода из официальной документации по миграции, разбирающий многокомпонентное расширение:

[ok]    conductor
          - skills      : skipped (not found)
          - agents      : skipped (not found)
          ✔ commands    : 6 processed (converted to skills)
          - mcpServers  : skipped (not found)
          - hooks       : skipped (not found)
[ok]    google-workspace
          ✔ skills      : 6 processed
          - agents      : skipped (not found)
          ✔ commands    : 4 processed (converted to skills)
          ✔ mcpServers  : 1 processed
          - hooks       : skipped (not found)

10. Шаг 4: Перенесите конфигурации MCP

Gemini CLI хранил настройки MCP-серверов внутри settings.json. Antigravity CLI использует отдельный файл. Перенесите их:

И одно переименование поля в самом JSON:

// Gemini CLI (settings.json)
{
  "mcpServers": {
    "my-remote-mcp": {
      "url": "https://example.com/mcp"   // or the deprecated "httpUrl"
    }
  }
}

// Antigravity CLI (mcp_config.json)
{
  "my-remote-mcp": {
    "serverUrl": "https://example.com/mcp"
  }
}

Удаленные MCP-серверы будут молча выдавать ошибку, если вы скопируете url без переименования. Записи локальных MCP-серверов с command + args переименовывать не нужно. Для ознакомления с основами конфигурации MCP см. наше руководство по MCP.

11. Шаг 5: Переместите навыки воркспейса

Глобальные навыки в ~/.gemini/skills/ загружаются автоматически — никаких действий не требуется. Навыки воркспейса в .gemini/skills/ должны быть перемещены в .agents/skills/:

# Per project, from the workspace root:
mkdir -p .agents
git mv .gemini/skills .agents/skills
# Or, if not in git:
mv .gemini/skills .agents/skills

Если в воркспейсе уже была папка .agents/skills/ (случай с двойным расположением, который допускался в документации Gemini CLI), оставьте её и удалите .gemini/skills/ копию. Паттерны создания описаны в нашем Руководство по настройке навыков Antigravity.

12. Шаг 6: Проверка хуков и контекста

Две вещи, которые нужно подтвердить, прежде чем считать миграцию завершенной:

• Файлы контекста загружаются. GEMINI.md и AGENTS.md в рабочем пространстве, а также ~/.gemini/GEMINI.md глобально — все они продолжают работать без изменений. Откройте сессию и попросите агента процитировать известное правило из вашего файла.
• JSON-хуки срабатывают. Если вы создавали JSON-хуки для Antigravity 2.0 или Gemini CLI, они применяются в Antigravity CLI в те же моменты жизненного цикла. Измените файл или запустите тестовый вызов инструмента, чтобы убедиться, что знакомый вам хук действительно срабатывает.

Паттерны правил см. в наших примерах правил и руководстве по системным промптам GEMINI.md.

13. Шаг 7: Валидация на реальной задаче

Шаг, который нельзя пропускать. Выберите задачу, которую вы выполняли вчера в Gemini CLI — рефакторинг, исследовательскую сессию или редактирование нескольких файлов — и запустите её в Antigravity CLI в том же репозитории. Сравните:

• Использовал ли агент те же инструменты на тех же этапах?
• Сработали ли слэш-команды ваших навыков в нужных местах?
• Выполнялись ли вызовы MCP-сервера? (Следите за скрытыми serverUrl ошибками здесь.)
• Повлияли ли файлы контекста (GEMINI.md, AGENTS.md) на поведение таким же образом?
• Вызывались ли хуки в ожидаемые моменты жизненного цикла?

Двадцать-тридцать минут на выполнение типовой задачи дадут вам 90% необходимой информации. Если всё воспроизводится — этого достаточно. Если что-то сломается, зафиксируйте ошибку и вернитесь к Gemini CLI для этого рабочего процесса, пока не появится исправление.

14. План отката

Antigravity CLI и Gemini CLI сосуществуют на одной машине. Это разные бинарные файлы (agy против gemini), с отдельными деревьями конфигурации (~/.gemini/antigravity-cli/ рядом с ~/.gemini/), а также раздельные процессы аутентификации. До 18 июня 2026 года ваш план отката для любого отдельного воркфлоу прост: продолжать использовать gemini для этой конкретной задачи.

После 18 июня варианты отката сужаются до:

• Переход на корпоративную лицензию (Gemini Code Assist Standard / Enterprise).
• Переход на платный Gemini API ключ.
• Использование Antigravity 2.0 (GUI) вместо CLI для затронутого воркфлоу.
• Использование совершенно другого CLI-агента. См. наш обзор альтернатив для понимания текущей ситуации.

15. Краткий обзор изменений

16. FAQ

17. Вердикт

Если вы планируете сделать сегодня только что-то одно: установите Antigravity CLI на ту машину, где вы чаще всего использовали Gemini CLI. Все остальное потребует гораздо меньше усилий.

Источники

• Google Developers Blog — Важное обновление: переход с Gemini CLI на Antigravity CLI
• @geminicli в X — анонс перехода
• Antigravity CLI — Миграция с Gemini CLI (официальная документация)
• Представляем Google Antigravity CLI — antigravity.google
• Представляем Google Antigravity 2.0 — antigravity.google
• Обзор Antigravity CLI — официальная документация
• google-antigravity/antigravity-cli — репозиторий GitHub