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 |