Antigravity Cli

Управление CLI Antigravity (agy): плагины, аутентификация, песочница.

Метаданные навыка

Источник	Опционально — установка через vibeos skills install official/autonomous-ai-agents/antigravity-cli
Путь	optional-skills/autonomous-ai-agents/antigravity-cli
Версия	0.2.0
Автор	Tony Simons (asimons81), VibeOS
Лицензия	MIT
Платформы	linux, macos, windows
Теги	Coding-Agent, Antigravity, CLI, Auth, Plugins, Sandbox
Связанные навыки	grok, codex, claude-code, vibeos-agent

Справочник: полный SKILL.md

к сведению

Ниже приведено полное определение навыка, которое VibeOS загружает при его активации. Это те инструкции, которые видит агент, когда навык активен.

CLI Antigravity (agy)

Руководство оператора для CLI Antigravity, вызываемого как agy. Запускайте все команды agy через инструмент terminal VibeOS; просматривайте его конфигурацию и логи с помощью read_file. Этот навык является справочным + процедурным — он не оборачивает сетевой API, поэтому аутентификация из самого VibeOS не требуется.

Когда использовать

• Установка, обновление или smoke-тестирование бинарного файла agy
• Выполнение неинтерактивных одноразовых команд agy --print / agy -p
• Отладка аутентификации, песочницы, разрешений или состояния плагинов Antigravity
• Чтение настроек, привязок клавиш, диалогов или логов Antigravity

Ментальная модель

Antigravity имеет два уровня — держите их раздельно, иначе руководство будет неверным:

1. Команды-обёртки оболочки — agy help, agy install, agy plugin, agy update, agy changelog. Запускаются через инструмент terminal.
2. Интерактивные слеш-команды внутри сессии — /config, /permissions, /skills, /agents и т.д. Они существуют только внутри запущенной TUI-сессии agy, а не в обёртке оболочки.

agy help показывает поверхность команд-обёрток, НЕ слеш-команды внутри сессии.

Предварительные требования

• Бинарный файл agy в PATH. Проверьте через инструмент terminal: command -v agy && agy --version.
• Для этого навыка не требуются переменные окружения или ключи API — Antigravity управляет своей аутентификацией через системную связку ключей ОС / вход через браузер (см. Аутентификация ниже).

Как запускать

Вызывайте каждую команду agy через инструмент terminal. Примеры:

terminal(command="agy --version")
terminal(command="agy help")
terminal(command="agy plugin list")
terminal(command="agy --print 'Опиши репозиторий в 3 пунктах'", workdir="/path/to/project")

Для интерактивной многошаговой TUI-сессии запустите agy с pty=true (и tmux для захвата/мониторинга) — тот же шаблон, что используется в навыках codex / claude-code. Для одноразовых smoke-тестов и скриптовых подсказок предпочитайте agy --print (неинтерактивный режим).

Для просмотра собственных файлов Antigravity используйте read_file на путях, указанных в разделе «Основные пути» ниже — не используйте cat через терминал.

Шаблоны делегирования

agy — это бэкенд агента-программиста из того же семейства, что и codex / claude-code, поэтому применимы те же шаблоны делегирования. Используйте их, когда передаёте Antigravity реальную работу (функции, исправления, ревью, второе мнение), а не просто проводите smoke-тестирование.

Одноразовый вызов (предпочтительно для скриптовых подсказок и второго мнения)

terminal(command="agy -p 'Проверь этот diff на наличие багов и проблем безопасности' --model 'Gemini 3.1 Pro (High)'", workdir="/path/to/repo", timeout=300)

-p — неинтерактивный режим: он выполняет подсказку и завершается. Выберите движок с помощью --model (выполните agy models для точных отображаемых строк, например, 'Gemini 3.1 Pro (High)', 'Claude Opus 4.6 (Thinking)'). Добавьте дополнительные корневые каталоги контекста с помощью повторяемого --add-dir.

Длительные / ограниченные по времени запуски (тесты, сборки, многофайловые изменения)

Запустите в фоне и получите уведомление о завершении, как в навыке codex:

terminal(command="agy -p 'Реализуй изменения, описанные в TASK.md, и запусти тесты' --dangerously-skip-permissions", workdir="/path/to/repo", background=true, notify_on_complete=true)
# затем: process(action="poll"/"log"/"wait", session_id=<id>)

Интерактивный многошаговый режим (PTY + tmux)

Для диалоговой сессии запустите agy -i (или просто agy) с pty=true и tmux для capture-pane / send-keys — точно такой же шаблон, как описано в навыках codex / claude-code. Возобновите позже с помощью --continue / -c или конкретного --conversation <id>.

Параллельные экземпляры (пакетная обработка подзадач / развёртывание worktree)

Создайте один git worktree на задачу и запустите независимый agy -p в каждом (в фоне), затем соберите результаты — то же развёртывание worktree, которое навык codex использует для пакетного исправления задач. Ограничьте параллелизм тем, что может выдержать машина и ваша способность к ревью.

Вывод и ограничения (отличие от Claude Code)

• agy -p возвращает простой текст — нет --output-format json и нет обёртки результата с session_id / стоимостью / количеством шагов. Парсите stdout напрямую; не ожидайте JSON-объекта.
• Нет --max-turns. Одноразовый запуск ограничен --print-timeout (по умолчанию 5m). Увеличьте для длительных задач: --print-timeout 20m. Сочетайте с timeout= инструмента terminal, чтобы внешний вызов не прервал выполнение раньше времени.

Границы оркестрации

Antigravity — это бэкенд для выполнения задач или рецензент для второго мнения — деталь выполнения, принадлежащая агенту/профилю, выполняющему задачу, а НЕ примитив оркестрации первого уровня. Не помещайте agy на канбан-доску как отдельную карточку и не рассматривайте его как слой координации; направляйте работу через обычный граф задач и пусть назначенный исполнитель выбирает agy (вместо codex/claude-code/прямых инструментов) как свой метод. Используйте его явно только когда пользователь просит, когда исполнитель настроен на его использование, или когда вам нужна перекрёстная проверка из семейства Gemini против плана или diff другого агента.

Основные пути

• Бинарный файл / точка входа: agy
• Каталог данных приложения: ~/.gemini/antigravity-cli/
• Файл настроек: ~/.gemini/antigravity-cli/settings.json
• Файл привязок клавиш: ~/.gemini/antigravity-cli/keybindings.json
• Логи: ~/.gemini/antigravity-cli/log/cli-*.log
• Диалоги: ~/.gemini/antigravity-cli/conversations/
• Артефакты мозга: ~/.gemini/antigravity-cli/brain/
• История: ~/.gemini/antigravity-cli/history.jsonl
• Промежуточное хранение плагинов: ~/.gemini/antigravity-cli/plugins/<plugin_name>/

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

Команды-обёртки

• agy changelog
• agy help
• agy install
• agy plugin / agy plugins
• agy update

Полезные флаги

• --add-dir
• --continue / -c
• --conversation
• --dangerously-skip-permissions
• --print / -p
• --print-timeout
• --prompt
• --prompt-interactive / -i
• --sandbox
• --log-file
• --version

Подкоманды плагинов (agy plugin --help)

• list, import [source], install <target>, uninstall <name>, enable <name>, disable <name>, validate [path], link <mp> <target>, help

Флаги установки (agy install --help)

• --dir, --skip-aliases, --skip-path

Слеш-команды внутри сессии

• Управление диалогом: /resume (/switch), /rewind (/undo), /rename <name>, /clear, /fork, /reset, /new
• Настройки и инструменты: /config, /settings, /permissions, /model, /keybindings, /statusline, /tasks, /skills, /mcp, /open <path>, /usage, /logout, /agents
• Помощники ввода: автодополнение пути @, esc esc очищает подсказку (когда не идёт потоковая передача), ! выполняет команду терминала напрямую, ? открывает справку

Настройки и разрешения

Часто используемые ключи настроек (settings.json)

• allowNonWorkspaceAccess
• colorScheme
• permissions.allow
• trustedWorkspaces

Режимы разрешений

request-review, always-proceed, strict, proceed-in-sandbox.

Поведение песочницы

• enableTerminalSandbox — логическое значение в settings.json; по умолчанию false.
• Переопределения при запуске (--sandbox, --dangerously-skip-permissions) могут заменять постоянные настройки для текущей сессии.

Поведение аутентификации

• CLI сначала пытается использовать защищённую системную связку ключей ОС.
• При отсутствии сохранённой сессии используется вход через браузер Google.
• Локально открывается браузер по умолчанию; через SSH выводится URL авторизации и ожидается вставка кода авторизации.
• /logout удаляет сохранённые учётные данные.

Плагины

• Плагины размещаются в ~/.gemini/antigravity-cli/plugins/<plugin_name>/.
• Они могут включать навыки, агентов, правила, MCP-серверы и хуки.
• agy plugin list, возвращающий пустой список импортированных плагинов, является допустимым пустым состоянием.

Подводные камни

• agy help показывает команды-обёртки, а не интерактивные слеш-команды.
• agy --version — безопасная неинтерактивная проверка версии; agy version — интерактивна и может завершиться ошибкой без реального TTY.
• Первое место для поиска ошибок: ~/.gemini/antigravity-cli/log/cli-*.log (читать с помощью read_file).
• Не путайте постоянные JSON-настройки с переопределениями при запуске.
• ~/.gemini/antigravity-cli/bin/agentapi — тонкая обёртка для agy agentapi.
• На WSL хранение токенов основано на файлах, поэтому проблемы с аутентификацией обычно связаны с локальными файлами / состоянием сессии, а не только с браузером.
• Идентификация рабочей области может зависеть от каталога запуска и маркера проекта .antigravitycli.
• agy -p выводит только простой текст — нет --output-format json, нет обёртки результата. Не пытайтесь извлечь JSON-объект (в отличие от claude-code).
• Ограничивайте одноразовые запуски с помощью --print-timeout (по умолчанию 5m), а не --max-turns (которого не существует в agy).

Проверка

Убедитесь, что установка реальна и работоспособна, используя инструмент terminal (читайте файлы с помощью read_file):

1. terminal(command="command -v agy")
2. terminal(command="agy --version")
3. terminal(command="agy help")
4. terminal(command="agy plugin list")
5. read_file для ~/.gemini/antigravity-cli/settings.json
6. read_file для последнего ~/.gemini/antigravity-cli/log/cli-*.log
7. При необходимости read_file для ~/.gemini/antigravity-cli/keybindings.json

Вспомогательные файлы

• references/cli-docs.md — сжатые заметки из документации по началу работы, использованию и функциям.