Краткий справочник

Google Antigravity CLI (agy): Команды и настройка — Шпаргалка

Компактное справочное руководство по терминальному AI-агенту Google Antigravity CLI (agy): флаги запуска и подкоманды, слэш-команды и горячие клавиши TUI, настройка .agents/ и mcp_config.json, а также чек-лист миграции с Gemini CLI.

· Опубликовано

Antigravity CLI (agy) — лёгкий нативный терминальный агент программирования от Google на базе Go в составе платформы Antigravity 2.0. Спроектированный для параллельного запуска субагентов, изоляции через Git worktree, Agent Skills, плагинов и интеграций MCP, agy приходит на смену потребительскому Gemini CLI.

Эта шпаргалка охватывает флаги и подкоманды agy CLI, интерактивные слэш-команды, горячие клавиши, конфигурацию .agents/ и mcp_config.json, а также шаги миграции с Gemini CLI.

🔗 Связанные шпаргалки: Сравнение терминальных AI-агентов CLI · Шпаргалка по Claude Code CLI · Шпаргалка по OpenAI Codex CLI · Архитектура и разработка AI Agent Skills


1. Установка, подкоманды и флаги запуска

1.1 Установка и запуск

# Установить Antigravity CLI
curl -fsSL https://antigravity.google/cli/install.sh | bash

# Запустить интерактивный TUI (при первом запуске следуйте подсказкам авторизации на экране)
agy

1.2 Основные подкоманды и флаги запуска

Команда / Флаг Описание Пример использования
agy Запустить интерактивный TUI в активной рабочей области agy
agy -p "<prompt>" Неинтерактивный (headless) запуск, выводит результат в stdout и завершается agy -p "Summarize the last 5 commits"
agy -i "<prompt>" Запустить интерактивную сессию с предзаполненным стартовым промптом agy -i "Refactor auth middleware under src/auth"
agy -c, --continue Возобновить последнюю сессию диалога agy -c
agy --conversation <id> Загрузить конкретный исторический диалог по ID agy --conversation 42a506e6-...
--mode <mode> Задать режим прав на выполнение:
default · accept-edits · auto (автоподтверждение в песочнице) · plan
agy --mode accept-edits
--model <model> Переопределить активную модель для текущей сессии agy --model gemini-3.8-flash
--effort <level> Задать глубину рассуждений (low до max, зависит от модели) agy --effort high
--agent <agent> Подключить пользовательский профиль агента при запуске agy --agent reviewer
--add-dir <path> Предоставить контексту рабочей области доступ к дополнительному каталогу (повторяемый) agy --add-dir ../shared-types
agy models / agy agents Вывести список доступных моделей или настроенных пользовательских агентов agy models
agy plugin <subcmd> Управление плагинами: install · list · validate --strict · import gemini agy plugin validate --strict ./my-plugin

2. Интерактивные слэш-команды в TUI

Введите / внутри agy для вызова и автодополнения встроенных команд:

2.1 Общее управление, сессия и история

Команда Функция Примечания и применение
? / /help Показать все доступные слэш-команды и горячие клавиши Быстрая справка во время сессии
/config / /settings Открыть полноэкранный интерактивный оверлей настроек Редактирование параметров, тем и прав доступа (settings.json)
/clear Очистить буфер активного промпта и начать новую сессию Чистое переключение на несвязанную задачу
/compact Сжать и резюмировать историю диалога Освобождение места в контексте на длинных прогонах
/resume Открыть список диалогов для восстановления прежних сессий Продолжение прерванных рабочих процессов
/rewind / /undo Пошагово откатиться назад по ходам диалога Отмена ошибочных шагов или неверного направления
/fork Разветвить диалог в текущей контрольной точке Безопасное исследование параллельных веток рабочей области
/exit / /quit Завершить сессию agy CLI Либо нажмите Ctrl + D Ctrl + D

2.2 Модели, рабочие процессы, агенты и расширения

Команда Функция Примечания и применение
/model Переключить активную AI-модель по ходу сессии Баланс скорости/стоимости и глубины рассуждений
/effort Проверить или задать уровень рассуждений (low — max) Примечание: agy -p "/effort" возвращает JSON только для чтения
/plan Сгенерировать пошаговый план до изменения файлов Предохранитель перед масштабными архитектурными правками
/goal Работать автономно до завершения без промежуточных пауз Подходит для длительных многоэтапных задач
/grill-me Провести интерактивное интервью по требованиям до начала кодинга Заранее прояснить крайние случаи и критерии приёмки
/agent Переключить или вызвать пользовательские профили субагентов/агентов Загружает определения из .agents/agents/
/worktree Создать или управлять изолированными каталогами Git worktree Работа в параллельных ветках без засорения основного дерева
/mcp Проверить статус MCP-соединений в реальном времени, логи и перезагрузить конфиг Диагностика локальных и удалённых MCP-серверов
/plugin Просматривать, включать, отключать и инспектировать плагины Marketplace Управление пакетными навыками, правилами, хуками и MCP-серверами
/voice Переключить режим голосового ввода (диктовки) Эквивалентная клавиша: F5

3. Горячие клавиши терминала и синтаксис ввода

Сочетание / Синтаксис Действие Эффект и сценарий
@<path> Автодополнение путей к файлам Подставляет конкретные пути к файлам или каталогам в контекст
!<command> Выполнение shell-команды в строке Начинайте с !, чтобы запускать команды оболочки напрямую (напр., !npm run build)
Ctrl + G Открыть внешний редактор Пишите длинные или многострочные промпты в редакторе по умолчанию (Vim, VS Code)
Esc Esc Очистить поле активного промпта Очищает набранный ввод, когда активного потока генерации нет
F5 Переключить голосовой ввод Эквивалент команды /voice
Ctrl + D Ctrl + D Завершить сессию Двойное нажатие Ctrl + D для чистого выхода

4. Иерархия конфигурации и mcp_config.json

4.1 Карта глобальных и проектных каталогов

Уровень Глобальная область (все проекты) Область рабочей области (локально в проекте) Назначение
Настройки CLI ~/.gemini/antigravity-cli/settings.json — Предпочтения CLI, тема, редактор и права по умолчанию
Горячие клавиши ~/.gemini/antigravity-cli/keybindings.json — Пользовательские привязки клавиш терминала
Инструкции проекта ~/.gemini/AGENTS.md или GEMINI.md ./AGENTS.md или ./GEMINI.md Постоянные соглашения репо, команды сборки/тестов, персона
Всегда активные правила ~/.gemini/config/rules/*.md .agents/rules/*.md Фоновые ограничения, автоматически подмешиваемые в контекст
Agent Skills ~/.gemini/config/skills/<name>/SKILL.md .agents/skills/<name>/SKILL.md Модульные пакеты Agent Skills со скриптами и ресурсами
Конфигурация MCP ~/.gemini/config/mcp_config.json .agents/mcp_config.json Описания локальных stdio и удалённых HTTP MCP-серверов

⚠️ Несовместимое изменение схемы удалённого MCP (serverUrl): В файле mcp_config.json удалённые HTTP MCP-серверы обязаны использовать ключ serverUrl вместо устаревших url или httpUrl — использование url приводит к тихим сбоям подключения.

{
  "mcpServers": {
    "remote-docs": {
      "serverUrl": "https://docsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "local-tool": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.example.com/mcp"]
    }
  }
}

5. Миграция с устаревшего Gemini CLI на agy

Бесплатный потребительский тариф и запросы Google AI Pro/Ultra в Gemini CLI прекратили работу 18 июня 2026 года (оставив только корпоративный Gemini Code Assist и тарифицируемые сценарии по API-ключу). Ключевые соответствия при миграции на agy:

Компонент Устаревший Gemini CLI Antigravity CLI (agy) Действие при миграции
Рантайм и бинарник Открытый TypeScript (gemini) Мультиагентный CLI на Go (agy) Переведите вызовы на agy; первичная настройка запускается автоматически
Расширения Расширения Gemini CLI Нативные плагины Antigravity Выполните agy plugin import gemini для конвертации и импорта
Файлы инструкций GEMINI.md GEMINI.md и AGENTS.md Полная совместимость — существующий GEMINI.md работает без правок
Локальный путь Skills .gemini/skills/ .agents/skills/ Переместите папки навыков в .agents/skills/<name>/SKILL.md
Старые Workflows .agents/workflows/ Перенесены в Agent Skills Конвертируйте однофайловые workflow в .agents/skills/ (/migrate-workflows)
Конфиг и ключи MCP Встроен в settings.json с ключом url Выделенный mcp_config.json с ключом serverUrl Вынесите блоки MCP в mcp_config.json и переименуйте url в serverUrl

Связанные темы