Antigravity CLI — агент Google для программирования в терминале. Вы ставите его одним скриптом, запускаете командой agy в папке проекта, входите через аккаунт Google и описываете задачу. Агент читает файлы, предлагает правки и команды, а в режиме по умолчанию спрашивает разрешения, прежде чем что-то менять.
Если вы пользовались Gemini CLI с личного аккаунта, то оказались именно здесь. Google объявила в блоге для разработчиков 19 мая 2026 года, что с 18 июня 2026 года Gemini CLI перестаёт обслуживать подписчиков Google AI Pro и Ultra и бесплатных пользователей Gemini Code Assist для частных лиц. В руководстве — установка, вход, инструкции проекта, модели и effort, режимы и права, MCP, главные команды, переход с Gemini CLI и лимиты, которые называет Google. Всё основано на документации Antigravity по состоянию на ноябрь 2026 года.
Что такое Antigravity CLI и кому он нужен
Antigravity CLI — терминальный клиент Google Antigravity, платформы разработки Google, построенной вокруг агентов. По словам Google, он написан на Go и использует тот же движок агента, что и десктопное приложение Antigravity 2.0, так что улучшения агента приходят в оба. Знакомые по Gemini CLI элементы остались: agent skills, хуки, субагенты и расширения, которые теперь называются плагинами.
Он для вас, если вы:
- пользовались Gemini CLI с личным аккаунтом Google, Google AI Pro или Ultra;
- хотите агента для программирования в терминале на моделях Gemini (а в зависимости от тарифа — и на других);
- уже работаете в Antigravity на десктопе и хотите того же агента по SSH или в скриптах.
Команды с лицензией Gemini Code Assist Standard или Enterprise либо с платным ключом API могут остаться на Gemini CLI — об этом наше руководство по Gemini CLI. Google не скрывает разницу: в анонсе прямо сказано, что полного совпадения функций 1:1 на старте не будет.
Установка
| Система | Команда |
|---|---|
| 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 |
На macOS и Linux бинарник окажется в ~/.local/bin/agy, на Windows — в AppData\Local\agy\bin. Проверьте:
agy --version
Вход
Перейдите в проект и запустите:
cd my-project
agy
При первом запуске agy спросит цветовую схему, режим отображения (Alt-Screen или Inline) и доверяете ли вы папке. Затем откроется браузер для входа через аккаунт Google. Работают личные аккаунты на тарифах Free, Pro и Ultra; рабочие аккаунты входят через Gemini Enterprise. Токен хранится в системном хранилище ключей (Keychain, Secret Service или диспетчер учётных данных Windows), поэтому при следующих запусках браузер не нужен.
Другие варианты:
- По SSH:
agyвыведет ссылку. Откройте её на своём компьютере, войдите и вставьте код в терминал. - Ключ Gemini API: укажите
"modelProvider": "gemini"в~/.gemini/antigravity-cli/settings.jsonи задайтеGEMINI_API_KEY. Без этой настройки ключ сам по себе ничего не делает. - Учётные данные Google Cloud: выполните
gcloud auth application-default loginи задайтеAGY_ADC_AUTH=true.
/logout удаляет сохранённый вход.
Первая задача
Объясни, как устроен модуль платежей, затем добавь проверку входных
данных в эндпоинт возврата и запусти тесты.
Несколько сокращений пригодятся сразу: @ подсказывает пути к файлам, ! в начале запроса запускает команду оболочки, ? показывает справку и slash-команды. Для скриптов agy -p "кратко опиши README.md" выполняет один запрос без интерфейса и печатает ответ; добавьте --output-format json, если результат читает другая программа. agy -i "запрос" открывает интерактивный интерфейс сразу с первым запросом.
Инструкции проекта: AGENTS.md или GEMINI.md
Antigravity читает AGENTS.md или GEMINI.md в папке, где вы запускаете agy, и в родительских папках до корня репозитория. Оба файла всегда активны и не требуют frontmatter. Глобальные правила кладут в ~/.gemini/AGENTS.md или ~/.gemini/GEMINI.md. Правила складываются, а не заменяют друг друга.
# Проект: billing-service
## Команды
- Установка: npm ci
- Тесты: npm test (запускать, прежде чем сказать, что задача готова)
## Нельзя
- Не править файлы в src/generated.
Для тонкой настройки положите Markdown-файлы в .agents/rules/. Каждому нужен frontmatter с полем trigger: always_on, model_decision, glob (срабатывает, когда агент трогает подходящие файлы) или manual. Без корректного trigger правило молча отбрасывается, а правила manual в CLI не работают: упоминаний правил там нет. Держите файлы короткими: каждый обрезается после 24 000 байт, а глобальные правила и правила always_on делят общий бюджет в 20 000 токенов.
Если Codex или другой агент уже читает ваш AGENTS.md, Antigravity возьмёт тот же файл. Как держать один набор правил вместе с Claude Code, рассказано в статье CLAUDE.md и AGENTS.md.
Модели и effort
Модель на один запуск задаётся через --model (список выдаёт agy models), в сессии — через /model. На странице моделей Google рядом с моделями Gemini, например Gemini 3.8 Flash и Gemini 3.1 Pro, перечислены модели Claude и GPT-OSS; какие из них доступны, зависит от тарифа.
Effort определяет, насколько глубоко модель рассуждает. /effort открывает шкалу и сохраняет выбор как значение по умолчанию; --effort low действует только на один запуск. Уровни — low, medium, high, xhigh и max, но большинство моделей предлагает только от low до high, а модели с фиксированным бюджетом этот параметр игнорируют.
Режимы и права
| Режим | Что происходит |
|---|---|
default | Показывает diff перед созданием или изменением файлов и спрашивает перед командами терминала |
accept-edits | Одобряет правки внутри workspace, но перед командами по-прежнему спрашивает |
auto | Одобряет правки и выполняет команды в песочнице терминала; рискованные действия всё равно требуют подтверждения |
plan | Анализирует и расписывает шаги до написания кода |
Запускайте с --mode=accept-edits (или auto, plan), переключайтесь через Shift+Tab или задайте "agentMode" в ~/.gemini/antigravity-cli/settings.json. Для auto нужны песочница и личный аккаунт (v1.3.5+ на macOS и Linux, v1.4.4+ на Windows); у рабочих аккаунтов этого режима нет. --sandbox запускает сессию в песочнице терминала.
Точные правила хранятся в том же файле списками allow, ask и deny, например command(git) или mcp(sql/execute_mutation). Deny важнее ask, ask важнее allow. /permissions редактирует их в интерфейсе. --dangerously-skip-permissions одобряет всё подряд — используйте его только в одноразовой среде. Почему — в статье о безопасности ИИ-агентов для кода.
MCP-серверы
MCP-серверы живут в отдельном файле: ~/.gemini/config/mcp_config.json для всех проектов и .agents/mcp_config.json для одного workspace.
{
"mcpServers": {
"local-db": { "command": "node", "args": ["/path/to/server.js"] },
"docs": { "serverUrl": "https://api.example.com/mcp/", "headers": { "Authorization": "Bearer TOKEN" } }
}
}
Удалённые серверы должны работать по Streamable HTTP; старый транспорт HTTP+SSE и поле httpUrl не поддерживаются. /mcp открывает менеджер со статусом, перезагрузкой и логами. Инструменты, которые вы не разрешили, работают в режиме Ask.
Команды, которые стоит знать
| Команда | Что делает |
|---|---|
/model, /effort | Меняет модель и глубину рассуждений |
/permissions | Управляет правилами allow, ask и deny |
/config или /settings | Открывает настройки |
/mcp | Менеджер MCP-серверов |
/plan | Изучает код, задаёт вопросы, пишет план для проверки |
/resume | Выбирает прошлый разговор из этой папки |
/rewind, /undo | Откатывает разговор назад |
/fork, /clear | Ответвляет разговор или начинает заново |
/usage, /credits | Квоты моделей и AI-кредиты |
/plugin | Устанавливает, включает или показывает плагины |
Из оболочки agy -c продолжает последний разговор в папке, а --conversation <id> открывает конкретный. --add-dir добавляет в workspace ещё одну папку.
Переход с Gemini CLI
При первом запуске agy на машине с настройками Gemini CLI появляется список: что перенести — расширения, глобальные настройки, токены сессии и параметры отображения. Что переносится, а что нет, по руководству по миграции от Google:
- Без изменений:
GEMINI.mdиAGENTS.mdв проекте,~/.gemini/GEMINI.mdи глобальные skills в~/.gemini/skills/. - Конвертируется: расширения становятся плагинами через
agy plugin import gemini, а их команды — skills. - Вручную: skills из workspace переносятся из
.gemini/skills/в.agents/skills/; MCP-серверы — из~/.gemini/settings.jsonвmcp_config.json, аurlилиhttpUrlпереименовываются вserverUrl. - Без гарантий: часть пользовательских тем и визуальных надстроек.
- Флаги:
--approval-modeбольше нет, вместо него--mode. Режима yolo нет.
Лимиты и цены
Страница тарифов Google включает CLI во все тарифы и описывает квоты без цифр: у Ultra самая большая квота, обновляется каждые пять часов; у Pro — большая квота, обновляется каждые пять часов до недельного лимита; у остальных тарифов квота обновляется раз в неделю. Лимиты зависят от объёма работы агента. На Pro и Ultra после исчерпания квоты могут расходоваться AI-кредиты по ценам потребления Gemini Enterprise, и это можно отключить в настройках. /usage и /credits показывают текущее состояние.
Рядом с Claude Code и Codex
Antigravity часто лишь один из нескольких агентов. Несколько привычек помогают не запутаться:
- Один общий файл правил. Antigravity и Codex читают
AGENTS.md; Claude Code читаетCLAUDE.md, который может на него ссылаться. - Отдельный worktree на агента. Дайте каждому агенту свой git worktree, чтобы они не правили одни и те же файлы.
- Одни и те же MCP-серверы везде. У каждого инструмента свой конфиг, так что один сервер приходится добавлять трижды.
Мы делаем AgentVera — десктопное приложение для macOS, Windows и Linux, которое запускает Antigravity CLI рядом с Claude Code, Codex, Gemini CLI и другими агентами, каждого в настоящем терминале с вашей установкой и вашим входом. Что касается Antigravity (подробнее):
- Рабочее пространство: Antigravity — одна ячейка в сетке агентов проекта; после перезапуска приложения он возвращается к своему разговору.
- Права: для каждого агента — Спрашивать, Авто (
--mode=accept-edits) или Полный доступ (--dangerously-skip-permissions). - Модель и effort: при создании агента выберите модель и effort low, medium или high.
- Инструкции: у agy нет флага для дополнительных инструкций, поэтому правила держите в
AGENTS.mdилиGEMINI.md. - MCP-менеджер: серверы, настроенные один раз, добавляются в Antigravity при запуске рядом с вашим
mcp_config.json. - Worktrees: создайте worktree в Git-панели и запустите в нём Antigravity, а Claude Code — в другом.
Сетка, worktrees, код-ревью и MCP-менеджер доступны на бесплатном тарифе. Как агенты Google соотносятся с агентами Anthropic, читайте в статье Gemini CLI или Claude Code — или скачайте AgentVera.
Итого
Установите скриптом, запустите agy, войдите через Google и оставьте свой AGENTS.md или GEMINI.md. Перенесите MCP-серверы в mcp_config.json, импортируйте расширения через agy plugin import gemini, начните в режиме default или accept-edits и перед долгими сессиями проверяйте /usage.