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.