Antigravity CLI (agy) на сервере

С 18 июня 2026 года Gemini CLI больше не обслуживает бесплатные личные аккаунты и аккаунты Google AI Pro и Ultra. Анонс Google направляет этих пользователей к Antigravity CLI, agy. На сервере внимания требуют вход без браузера, выбор между входом через Google и ключом API и понимание того, как agy обращается с разрешениями, когда за терминалом никого нет. Разберём по порядку.

Установка agy

На Linux или macOS, от вашего обычного пользователя (не root):

curl -fsSL https://antigravity.google/cli/install.sh | bash
export PATH="$HOME/.local/bin:$PATH"   # if ~/.local/bin isn't on PATH yet
command -v agy

На официальной странице установки сказано, что бинарник кладётся в ~/.local/bin/agy, и перечислены macOS, Linux и Windows. Установщик скачивает сборку под конкретную платформу, для Linux есть сборки и для amd64, и для arm64, так что VPS на ARM подойдёт. Добавьте строку с PATH в ~/.bashrc или ~/.profile, чтобы её подхватывали новые оболочки и окна tmux.

Одна особенность для сервера: agy обновляется сам в фоне. На ноутбуке это удобно. На машине, которую вы оставляете работать, это значит, что версия может смениться посреди долгой сессии. Maude фиксирует устанавливаемую версию и отключает это через AGY_CLI_DISABLE_AUTO_UPDATE=1. Если вам нужна та же предсказуемость, экспортируйте эту переменную в оболочке или юните, который запускает agy.

Вход по SSH

Запустите agy в SSH-сессии и выберите вход через Google. На ноутбуке он открыл бы браузер. По SSH он распознаёт удалённую сессию и вместо этого выводит ссылку для авторизации. Дальше:

1. Скопируйте ссылку и откройте её на телефоне или ноутбуке.
2. Войдите с аккаунтом Google, который вы используете для Antigravity.
3. Скопируйте код, который покажет страница, и вставьте его обратно в терминал.

Учётные данные хранятся в системной связке ключей, на Linux это Secret Service. На голом VPS нет сеанса рабочего стола, который разблокировал бы связку ключей. В issue на GitHub, заведённом для agy 1.0.0, сообщается о зацикленном входе на headless-Linux именно по этой причине, плюс об ошибке с часовым поясом в запасном хранении в файле. Обходной путь автора — GEMINI_FORCE_FILE_STORAGE=true TZ=UTC agy …. Мы не проверяли, нужно ли это в текущих версиях. Если agy просит войти заново при каждом запуске, сначала загляните в этот issue. В остальных случаях используйте режим с ключом API.

Чтобы выйти и удалить сохранённый профиль, выполните /logout внутри agy.

Режим с ключом API для headless

Для CI, общей машины или любого сервера, где вы не хотите держать сессию Google, запускайте agy на ключе Gemini API. Документация по установке описывает два шага. Сначала укажите поставщика моделей в ~/.gemini/antigravity-cli/settings.json. Если файл уже есть, добавьте это в него:

{
  "modelProvider": "gemini"
}

Затем сделайте ключ доступным процессу:

export GEMINI_API_KEY="…"   # e.g. in ~/.profile, or an EnvironmentFile for a systemd unit

Так вход в аккаунт полностью пропускается. Использование оплачивается за токены по ценам Gemini API, а не засчитывается в тариф Google AI. Не допускайте попадания ключа в историю оболочки и в репозиторий, с которым работает агент.

Разрешения, когда никто не смотрит

Именно это поведение на сервере удивляет больше всего. В наших тестах на agy 1.2.14 headless-запуски (agy -p … или режим stream-json) не могут остановиться и спросить перед запуском инструмента. Команда или запись в файл, которым нужно разрешение, отклоняются, и в результате хода они перечислены как отклонённые. Пропустить работу можно тремя способами:

• Разрешающие правила. agy читает их из permissions.allow в ~/.gemini/antigravity-cli/settings.json. Записи выглядят как "command(npm test)", "write_file(src/app.ts)" или "command(*)". Они читаются при запуске.
• Режимы. --mode accept-edits автоматически одобряет правки файлов, но команды по-прежнему отклоняются. --mode plan планирует, ничего не делая.
• Совсем без проверок. --dangerously-skip-permissions — для одноразовой машины. Прежде чем к нему тянуться, прочитайте статью о безопасном запуске агентов с полными правами.

Интерактивный agy в терминале и Remote Control (ниже) умеют остановиться и спросить. Так что это ограничение касается именно скриптового headless-использования.

Перенос конфигурации Gemini CLI

Этому посвящено руководство по переезду. Коротко — для сервера, на котором уже был Gemini CLI:

• Первый запуск предлагает перенос. Если agy находит существующую конфигурацию Gemini CLI, он показывает чек-лист расширений и глобальных настроек для конвертации.
• Расширения становятся плагинами. Выполните agy plugin import gemini в любой момент, чтобы сконвертировать расширения Gemini в плагины Antigravity.
• Файлы контекста работают как есть. GEMINI.md (в рабочей области и ~/.gemini/GEMINI.md) и AGENTS.md читаются без изменений.
• MCP-серверам нужна небольшая правка. Глобальные серверы живут в ~/.gemini/config/mcp_config.json, серверы рабочей области — в .agents/mcp_config.json. Переименуйте старые ключи url/httpUrl в serverUrl.
• Skills переезжают. Skills рабочей области переносятся из .gemini/skills/ в .agents/skills/, а глобальные — в ~/.gemini/antigravity-cli/skills/. Переносить их нужно вручную.

Google говорит, что полного паритета возможностей пока нет, а руководство по переезду отмечает, что некоторые пользовательские темы и визуальные настройки не переносятся. Если рабочий процесс зависит от конкретного расширения, проверьте его после импорта, прежде чем удалять старую установку.

Демон Remote Control или Maude

Google предлагает официальный способ добраться до agy с другого устройства. Согласно документации Remote Control, запустить его можно тремя способами:

• /remote-control внутри запущенной сессии. Туннель закрывается, когда эта сессия CLI завершается.
• agy --remote-control при запуске сессии. Этот туннель тоже закрывается вместе с сессией.
• Headless-демон: agy remote-control start --name my-vps, а также agy remote-control status и agy remote-control stop. Он регистрирует системную службу, которая продолжает работать в фоне.

Управление — из веб-панели в любом браузере с входом в тот же аккаунт Google. В документации сказано, что панель можно установить на главный экран телефона, чтобы получать push-уведомления, и что отвечать на запросы разрешений можно как из терминала, так и из удалённого интерфейса. Там же сказано, что функцию может заблокировать флаг аккаунта или организации.

Если Antigravity — ваш единственный агент и флаг функции для вашего аккаунта включён, официальный демон — очевидный первый выбор. Он бесплатный и умеет спрашивать перед действием.

Управление с телефона

Если вы хотите, чтобы agy работал на сервере рядом с другими агентами и управлялся из нативного приложения, Maude — один из вариантов. Добавьте сервер, и приложение установит agy в проверенной версии и выполнит вход с телефона — через Google со вставкой кода или с ключом Gemini API. Скажем честно об Antigravity в Maude: поскольку Maude управляет headless-agy, остановиться и спросить перед запуском инструмента она не может. Maude показывает вам отклонённое действие, а если вы его одобрите, добавляет разрешающее правило и повторяет попытку. Подробности — на странице агента Antigravity. О самом изменении в Gemini CLI и о том, на что ещё переходят люди, — в нашей статье о закрытии Gemini CLI.

Часто задаваемые вопросы

Что изменилось

• 1 октября 2026 г. — Первая публикация. Установка, аутентификация, перенос и Remote Control сверены с документацией antigravity.google; поведение разрешений в headless-режиме — по нашим собственным тестам на agy 1.2.14.