1. Введение
В этом практическом занятии вы познакомитесь с Antigravity CLI — облегченным интерфейсом пользовательского терминала (TUI) для Antigravity. Он предоставляет те же основные возможности агентного управления, что и Antigravity (например, многошаговое рассуждение, редактирование нескольких файлов, вызов инструментов и история диалогов), непосредственно на вашем терминале.
Что вы узнаете
- Установка и настройка Antigravity CLI
- Понимание основных принципов использования интерфейса командной строки Antigravity.
- Рассмотрим несколько вариантов использования Antigravity CLI.
Что вам понадобится
Вам потребуется следующее:
- Веб-браузер Chrome
- Личный аккаунт Gmail
Этот практический курс предназначен для пользователей и разработчиков всех уровней (включая начинающих). Примеры использования в курсе разделены на задачи для разработчиков и задачи для неразработчиков. Примеры для разработчиков демонстрируют, как работать с Antigravity CLI и репозиторием GitHub для выполнения распространенных задач разработки, таких как объяснение/понимание кода, создание документации, исправление ошибок и многое другое. Рекомендуется выполнить эти примеры в курсе. В конце есть дополнительный раздел, посвященный нескольким повседневным задачам, не ориентированным на разработчиков.
2. Установка
Прежде чем приступать к настройке и запуску Antigravity CLI, давайте создадим папку, которую будем использовать в качестве домашней папки для всех проектов, создаваемых внутри неё. Это отправная точка для работы Antigravity CLI, хотя она также будет ссылаться на некоторые другие папки в вашей системе, к которым вы вернетесь позже по мере необходимости.
Создайте тестовую папку ( agy-cli-projects ) и перейдите в неё с помощью команд, показанных ниже. Если вы предпочитаете использовать другое имя папки, пожалуйста, сделайте это.
mkdir agy-cli-projects
Давайте перейдём в эту папку:
cd agy-cli-projects
Установка проста, и исполняемые файлы доступны для основных операционных систем. Команды для запуска в терминале я взял непосредственно из инструкции по установке:
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
В идеале это должно настроить и установить Antigravity CLI ( agy ) в вашей системе и в Path.
В некоторых случаях, если установщик не может добавить исполняемый файл ( agy ) в PATH, он сообщит об этом. Например, вот пример вывода на компьютере, где установщик не смог добавить исполняемый файл в PATH и предложил, что делать дальше.
% curl -fsSL https://antigravity.google/cli/install.sh | bash
⠋ Detecting system environment...
✓ Platform detected: darwin_arm64
⠋ Querying release repository...
✓ Latest available version: 1.0.1
⠋ Downloading release package...
✓ Download complete and checksum verified.
⠋ Extracting binary from archive...
⠋ Configuring shell environment...
I0523 11:44:14.012088 76528 installer.go:27] Running Antigravity CLI setup...
Warning: /Users/neilirani/.local/bin is not present in your active PATH.
To use the 'agy' CLI globally, please manually add it to your shell profile:
echo 'export PATH="/Users/yourusername/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
✅ Antigravity CLI binary placed successfully at /Users/yourusername/.local/bin/agy
Note: The binary is installed, but it is not in your active PATH. Please follow the instructions above to add it, then restart your terminal session.
Проверьте версию Antigravity CLI с помощью следующей команды (показана версия на момент написания этого практического задания):
$ agy --version
1.0.7
При первом запуске Antigravity CLI вам будет предложено войти в систему. Запустите agy , и вы должны увидеть что-то подобное:
▄▀▀▄
▀▀▀▀▀▀
▀▀▀▀▀▀▀▀
▄▀▀ ▀▀▄
▄▀▀ ▀▀▄
Welcome to the Antigravity CLI. You are currently not signed in.
Select login method:
> 1. Google OAuth
2. Use a Google Cloud project
[Use arrow keys to navigate, Enter to select]
Пока используйте свой личный аккаунт. Выберите 1. Google OAuth и нажмите Enter . Откроется браузер, и вы сможете войти в систему с помощью своего аккаунта Google. После успешной аутентификации и авторизации вам будет предложено скопировать код. Пожалуйста, вернитесь в терминал Antigravity CLI и вставьте код.
После успешного входа в систему происходит несколько действий:
- Сначала система спросит вас о цветовой гамме, которую вы хотите выбрать для Antigravity CLI, как показано ниже. Выберите ту, которая вам нравится.
- Далее вам необходимо принять несколько условий предоставления услуг. Примите их.
Наконец, самое важное — дать разрешение на использование папки, как показано ниже:
Accessing workspace:
/Users/yourusername/agy-cli-projects
Do you trust the contents of this project?
Antigravity CLI requires permission to read, edit, and execute files here.
> Yes, I trust this folder
No, exit
↑/↓ Navigate · enter Confirm
Обычно это можно увидеть в любой новой папке, в которой вы запускаете Antigravity CLI. Мы подробнее рассмотрим это позже в этой серии, а пока можете смело сказать: «Да, я доверяю этой папке» .
Поздравляем! Теперь все готово, и Antigravity CLI ждет вашего запроса.
3. Наше первое взаимодействие с интерфейсом командной строки Antigravity.
Давайте начнём работу с Antigravity CLI и введём ваш первый запрос, как показано ниже:
Give me a famous quote on Artificial Intelligence and who said that?
Ниже представлен пример ответа:
Here is a famous quote on Artificial Intelligence:
│ "Artificial intelligence is the new electricity."
│ — Andrew Ng
Помимо подсказок, какие ещё команды поддерживает Antigravity CLI? Вы можете узнать это, набрав /help (косая черта). Откроются 3 вкладки: «Общие» , «Команды» и «Сочетания клавиш» . По умолчанию вы попадёте на вкладку «Общие» , где с помощью клавиши Tab сможете перейти к вкладке «Команды» , и там вы увидите множество команд. Также можно перейти к сочетаниям клавиш.
Ниже приведён список команд, доступных на момент написания статьи:
Примечание : Вы можете выйти из Antigravity CLI в любое время с помощью команды /quit или дважды нажать ctrl+d в интерактивном терминале Antigravity CLI.
4. Интерфейс командной строки Antigravity — несколько команд для управления процессом.
Убедитесь, что Antigravity CLI запущен и ожидает вашей команды. Если вы пробовали команду /quit в конце предыдущего раздела, пожалуйста, запустите Antigravity CLI снова с помощью команды agy .
Обратите внимание на используемую модель, название которой будет отображаться в правом нижнем углу. Прежде всего, желательно понимать, что большинство необходимых настроек и параметров доступны через команды /config или /settings .
Настройки / Параметры
Выполните команду /config . Это откроет различные разделы Antigravity, которые вы можете настроить в соответствии со своими предпочтениями. Сюда входят цветовая схема, права доступа к инструментам, настройки телеметрии и многое другое.
Settings
Search:
────────────────────
> Animation Speed medium
Artifact Review asks for review
Color Scheme dark
Editor auto ($EDITOR)
Enable Telemetry on
Non-Workspace Access off
Notifications off
Rendering Mode native terminal (inline)
Sandbox Mode off
Show Feedback Survey on
Show Tips on
Tool Permission request-review
Use AI Credits off
Verbosity high
Например, в меню «Цветовая схема» отображаются следующие варианты, из которых я могу выбрать предпочтительную цветовую схему:
settings.json
Настройки конфигурации нужно где-то хранить, верно? Все они хранятся в файле ~/.gemini/antigravity-cli/settings.json . Пример показан ниже:
{
"colorScheme": "dark",
"model": "Gemini 3.5 Flash (High)",
"statusLine": {
"type": "",
"command": "",
"enabled": true
},
"trustedWorkspaces": [
"/Users/romin/antigravity-cli-projects",
"/Users/romin/agy-cli-projects"
]
}
Вы можете заметить выбранную мной colorScheme , модель, а также различные папки, из которых я запустил Antigravity CLI и подтвердил доверие к этим папкам.
Примечание : Вы также можете напрямую изменить файл settings.json и перезапустить Antigravity CLI, чтобы увидеть изменения. Но убедитесь в правильности настроек, иначе при запуске отобразится ошибка. Если вам неудобно напрямую изменять файл, рекомендуется использовать команду /settings или /config в Antigravity CLI для работы с этим файлом.
Разрешение на использование инструмента
Важная настройка, которую необходимо понимать, — это права доступа к инструментам. Она определяет, требуется ли ваше разрешение для выполнения команд терминала. Доступ к ней можно получить с помощью команды /config .
Tool Permission
> request-review (current)
proceed-in-sandbox
always-proceed
strict
По умолчанию установлено значение request-review . Давайте разберемся в этом подробнее. В Antigravity настройки разрешений инструментов контролируют баланс между безопасностью (защита вашей хост-системы от непреднамеренных изменений) и скоростью (насколько автономно агент может работать, не прерывая выполнение запроса). Давайте рассмотрим доступные параметры:
Запрос на проверку (текущее значение по умолчанию)
В этом режиме агент рассматривается как партнер по сотрудничеству, который проверяет свою работоспособность перед выполнением любых действий, которые могут повлиять на вашу систему или файлы проекта за пределами предварительно согласованных границ. Всякий раз, когда агент пытается выполнить команду терминала, выполнить операцию с файлами (например, запись/удаление) или обратиться к внешней службе без предварительного согласования разрешения, выполнение приостанавливается. Пользователю предлагается подтвердить или отклонить конкретное действие.
продолжить в песочнице
Этот режим позволяет агенту автоматически выполнять команды терминала, но в защищенном, изолированном контейнере. Агент может выполнять команды без вашего запроса, но эти команды выполняются в виртуализированной песочнице (например, в легковесном контейнере). Он не может изменять файловую систему вашей хост-машины или получать доступ к вашей локальной сети.
всегда продолжать
Это полностью автономный режим, обеспечивающий агенту максимальную скорость и возможности. Агенту предоставляются полные права на выполнение команд и запись файлов непосредственно на вашем хост-компьютере. Он никогда не будет запрашивать у вас подтверждение.
строгий
Это режим нулевого доверия с высоким уровнем безопасности. Возможности агента ограничены выполнением инструментов чтения. Для всех инструментов, не связанных с чтением, потребуется запрос подтверждения действий от пользователя.
5. Параметры команды Antigravity CLI
При запуске Antigravity CLI можно указать несколько параметров командной строки. Чтобы получить полный список параметров, используйте опцию --help как показано ниже.
agy --help
Здесь должен быть представлен полный спектр доступных опций. Примерный список показан ниже:
Давайте рассмотрим некоторые из них.
Неинтерактивный режим (автономный)
Интересный вариант — запуск Antigravity CLI в неинтерактивном режиме. Это означает, что вы напрямую вводите команду, и программа сама на неё ответит, без открытия интерактивного терминала Antigravity CLI. Это очень полезно, если вы планируете использовать Antigravity CLI в автоматизированном режиме в рамках скрипта или любого другого процесса автоматизации.
Параметр -p используется для ввода командной строки в Antigravity CLI, как показано ниже:
agy -p "What is the gcloud command to deploy to Cloud Run"
Это может быть хорошим способом быстро получить ответы, но имейте в виду, что продолжить разговор с помощью дополнительных вопросов не получится.
Выберите конкретную модель
Первый способ — указать Antigravity CLI использовать определенный режим Gemini. Вы можете использовать параметр --model , чтобы указать Antigravity CLI использовать определенную модель только во время своей сессии. Это очень полезно для неинтерактивного режима, о котором мы упоминали в предыдущем разделе, когда вы хотите запустить несколько сессий agy и использовать определенные модели для определенных задач.
Но сначала вам нужно узнать, какие модели доступны для Antigravity CLI. Это можно сделать с помощью подкоманды models , как показано ниже:
agy models
Здесь будет перечислены модели, доступные для Antigravity CLI. Примерный список приведен ниже:
- Вспышка Gemini 3.5 (средняя)
- Вспышка Gemini 3.5 (высокая)
- Вспышка Gemini 3.5 (низкий уровень)
- Gemini 3.1 Pro (низкая версия)
- Gemini 3.1 Pro (High)
- Сонет 4.6 (Размышления) Клода
- Клод, опус 4.6 (Мышление)
- GPT-OSS 120B (средний)
Для указания модели, которая будет использоваться в сессии, можно использовать любое из этих имен моделей. Это можно сделать с помощью команды --model показанной ниже:
agy --model "Gemini 3.5 Flash (Low)"
После запуска Antigravity CLI вы можете проверить, какую именно модель вы указали для использования, либо с помощью команды /model , либо посмотреть в правом нижнем углу, где отображается модель, использованная в текущей сессии.
Жить опасно
Если вы любите рисковать, то можете воспользоваться параметром с очень подходящим названием --dangerously-skip-permissions . Он автоматически подтвердит все разрешения для инструментов. Запроса на подтверждение разрешений не будет. Поэтому используйте его с осторожностью.
Запустите Antigravity CLI с помощью следующей команды:
agy --dangerously-skip-permissions
Затем введите следующее сообщение. Убедитесь, что оно не запрашивало у меня права на запись в файл.
> get the latest news and write it in a file called news.txt. Then create another file that contains the summary of that file.
● ListDir(/Users/romin/agy-cli-projects)
● WebSearch(latest world news May 24 2026 news headlines) (ctrl+o to expand)
▸ Thought for 2s, 95 tokens
Processing News Information
● Create(/Users/romin/agy-cli-projects/news.txt)
● Create(/Users/romin/agy-cli-projects/summary.txt) (ctrl+o to expand)
I have fetched the latest world news headlines and created the requested files in your workspace:
1. news.txt: Contains the detailed news headlines for today (May 24, 2026), including topics on geopolitics (U.S.-Iran negotiations, Ukraine conflict), U.S.
security incidents, the Ebola outbreak in Central Africa, and the passing of NASCAR champion Kyle Busch.
2. summary.txt: Contains a concise, structured summary of the major categories covered in the news file.
Этот режим может быть полезен в ситуациях, когда все происходит локально и находится под вашим контролем, но при этом будьте готовы к неожиданностям и используйте его с осторожностью.
6. Интерфейс командной строки Antigravity — режим оболочки
Сейчас самое время научиться работать непосредственно с оболочкой из командной строки Antigravity. Вы можете перейти в режим оболочки, нажав восклицательный знак ! в окне сообщения. Это переключит вас в режим оболочки. Вернуться в этот режим можно, снова нажав восклицательный знак ! или клавишу ESC .
В режиме командной оболочки вы увидите восклицательный знак ! в начале приглашения командной строки, как показано ниже:
Вы можете проверить это напрямую, используя стандартные команды, такие как pwd и ls . Обратите внимание, что эти команды предполагают операционную систему типа Linux. Если вы используете другую операционную систему (Windows), используйте эквивалентные команды, например ( cd , dir и type ).
7. Варианты использования для тестирования
Интерфейс командной строки Antigravity CLI может применяться в самых разных областях, актуальных как для разработчиков, так и для тех, кто не занимается разработкой. Здесь представлены несколько сценариев, и в зависимости от ваших интересов вы можете попробовать любой из них или все сразу.
В каждом из этих случаев предоставляется соответствующая подсказка. Вы можете попробовать это в интерактивном режиме Antigravity CLI, чтобы лучше понять, как Antigravity CLI выполняет свою задачу.
Программирование Vibe с помощью Antigravity CLI
Давайте воспользуемся Antigravity CLI для создания приложения с помощью Vibe Code. В этом задании вы попросите Antigravity CLI сгенерировать приложение, а затем загрузить его начальную версию в репозиторий GitHub.
Предварительное условие
Для выполнения заданий в этом разделе необходимо выполнить несколько предварительных условий:
- Гит
- Антигравитационный CLI
- среда Python 3
- Настройте
gh( инструмент командной строки GitHub ). - Знание основ Git и базовые навыки программирования.
Предположим, вы запустили Antigravity CLI из выбранной вами папки . В нашем случае мы запустили Antigravity CLI из исходной домашней папки: agy-cli-projects и расположенной внутри неё папки bq-releases-notes .
Начните с первоначального запроса. Рассматривайте его как спецификацию вашего приложения. Вы можете изменять его по своему усмотрению. Имейте в виду, что на протяжении всего сеанса работы с Antigravity CLI вам будут запрашиваться разрешения на создание файлов и т.д. Предоставьте необходимые разрешения.
Please build a web application for me using Python Flask and plain vanilla HTML, JavaScript and CSS that fetches the BigQuery Release notes from (https://docs.cloud.google.com/feeds/bigquery-release-notes.xml) and shows them to me.
A simple refresh button with a spinner is good enough, anytime I'd like to refresh the details.
I would also like the ability to take any specific update, select it and then Tweet about it.
Следующие несколько подсказок и ответов представляют собой пример наблюдаемого сценария. Antigravity CLI разработает план и запросит у вас подтверждения/уточнения или продолжит. Пожалуйста, следуйте инструкциям. В качестве примера, вот мой образец диалога:
I will start by exploring the workspace to see if there is