Google Antigravity Remote Control: удалённое управление с телефона
MarkdownУзнайте, как настроить Remote Control в Google Antigravity на компьютере и в CLI: включение доступа, запуск демона agy remote-control и устранение неполадок подключения.
Читать статью полностью
В документации Ailoot собраны справочные материалы по работе с сервисом.
Кратко
В настольной версии Antigravity 2.0 функция Remote Control активируется переключателем в Settings → App. Для подключения откройте antigravity.google.com и войдите в тот же Google-аккаунт. В Antigravity CLI предусмотрено два варианта: команда /remote-control (либо параметр запуска --remote-control) создаёт туннель на период работы терминальной сессии, а agy remote-control start запускает фоновый демон, которому не требуется открытое окно терминала. В Linux демон продолжает работать после выхода из системы и запускается после перезагрузки. В Windows для такого режима требуется установка с правами администратора. В macOS и при стандартной установке Windows демон возобновляет работу при следующем входе пользователя. Компьютер должен оставаться включённым и иметь подключение к интернету. Доступность функции может зависеть от политики аккаунта или организации и условий тарифного плана.
Если Antigravity ещё не установлен, сначала прочитайте материал о том, что представляет собой Google Antigravity и как его установить. Эта инструкция пригодится, когда агент занят продолжительной работой — например, рефакторингом, запуском тестов или обновлением зависимостей, — а вам нужно отойти от компьютера и при этом не терять доступ к сессии.
Назначение Remote Control
Remote Control — функция Google Antigravity для защищённого подключения к настольным и CLI-сессиям на ваших компьютерах через веб-браузер. Согласно официальному описанию, такие задачи, как масштабный рефакторинг подсистемы, продолжительный запуск тестов или сложная миграция зависимостей, могут выполняться долго. Удалённое управление позволяет взаимодействовать с сессией, находясь вдали от компьютера, и продолжать работу в локальном окружении разработки.
Функция доступна как в настольном приложении версии 2.0, так и в CLI — терминальном варианте Antigravity (agy). Способ включения и особенности работы в них различаются.
Настройка Remote Control в настольном Antigravity 2.0
Активируйте удалённое управление в параметрах приложения:
- Откройте Settings сочетанием
Cmd + ,(на Linux и Windows —Ctrl + ,) либо нажмите Settings в нижней части левой панели. - Выберите раздел App.
- Переведите переключатель Enable Remote Control в состояние On.
- (По желанию) Укажите Nickname, например
workstation-primaryилиserver-machine, чтобы проще находить компьютер среди подключённых устройств.
Подключение со смартфона или через другой браузер
Для доступа к удалённой сессии выполните следующие действия:
- Откройте браузер на нужном устройстве и перейдите на панель управления Antigravity Remote Control. На смартфоне веб-приложение можно добавить на главный экран; тогда будут приходить push-уведомления о завершении задачи агентом или запросе ответа.
- Авторизуйтесь в том же Google-аккаунте, который используется на компьютере.
- В списке устройств выберите нужную машину.
- После соединения отобразятся активные диалоги. Можно поручать агенту новые задачи, изучать планы их выполнения и просматривать артефакты.
Если компьютер не отображается в веб-интерфейсе, официальная инструкция рекомендует проверить следующее: на компьютере с Antigravity активен переключатель Enable Remote Control; компьютер подключён к интернету и не находится в спящем режиме; в настольном приложении и браузере выполнен вход в один и тот же Google-аккаунт.
Если временно пропала сеть на устройстве, с которого вы подключаетесь, веб-интерфейс попытается восстановить связь автоматически. Фоновые задачи агента и команды, запущенные в терминале, продолжают выполняться на компьютере с Antigravity, если тот сохраняет подключение к интернету.
Два варианта Remote Control в Antigravity CLI
В CLI можно выбрать интерактивный режим, работающий в рамках конкретного процесса терминала, или фоновый headless-демон, которому открытый терминал не нужен.
Интерактивный вариант: /remote-control
Включить Remote Control можно прямо в текущем интерактивном сеансе agy, без перезапуска CLI. Введите:
/remote-control
Как описано в официальной документации, CLI создаёт обратный туннель для текущей сессии и выводит имя хоста и ссылку на активный диалог, чтобы открыть его с другого устройства:
Remote control on for this session.
Hostname: devbox-swift-falcon
Open https://antigravity.google.com/r/<instance-id>?p=c%2F<conversation-id> on another device to continue this conversation.
Перейдите по ссылке в браузере на ноутбуке, планшете или смартфоне. Войдите в тот же Google-аккаунт, который используется в CLI, и продолжите работу с сессией через веб-интерфейс Antigravity.
Отключить туннель, оставив локальный сеанс терминала активным, можно командой:
/remote-control off
Чтобы запустить CLI с уже включённым Remote Control, укажите параметр при старте:
agy --remote-control
Интерактивное подключение существует, пока работает процесс agy. При выходе из CLI (/exit, Ctrl+C, Ctrl+D) или закрытии окна терминала туннель прекращает работу, а запись сеанса пропадает с панели управления. У каждого интерактивного процесса CLI отдельный идентификатор сессии и имя хоста. Поэтому в разных вкладках терминала или рабочих каталогах можно одновременно запустить несколько экземпляров agy --remote-control.
При удалённом подключении к интерактивной CLI-сессии браузер и терминал синхронизируются в реальном времени. Запросы с другого устройства передаются в локальный терминал; ход работы агента, вызовы инструментов и правки кода отображаются в веб-интерфейсе. Если агент ожидает подтверждения (y/n) или просит уточнить детали, ответить можно со смартфона либо в локальном терминале. Настройки через удалённый веб-интерфейс изменить нельзя — для этого нужен сам CLI.
Фоновый демон: agy remote-control start
Другой вариант — постоянный фоновый демон, зарегистрированный как служба операционной системы. Он доступен, пока компьютер включён и подключён к интернету. Условия работы после выхода из системы и перезагрузки зависят от платформы.
agy remote-control start
Демон устанавливается как системная служба: systemd user service в Linux, LaunchAgent в macOS или Scheduled Task в Windows. Он запускается сразу, даже если окно терминала не открыто.
Имя зарегистрированного устройства можно узнать командой agy remote-control status. Затем выберите компьютер на панели Antigravity Remote Control, чтобы работать с ним через веб-интерфейс Antigravity.
Для управления демоном предназначены три команды:
agy remote-control start Register and start the daemon
agy remote-control status Show the daemon's status and instance name
agy remote-control stop Stop the daemon and unregister it
Демон пользуется учётными данными, с которыми вы вошли в CLI. Авторизация в CLI выполняется отдельно от входа в настольный редактор Antigravity на том же компьютере. Для браузера потребуется тот же Google-аккаунт, что используется в CLI.
При запуске headless-демона можно задать имя компьютера параметром --name:
agy remote-control start --name "my-workstation"
Если повторно запустить start --name с другим значением, имя машины будет изменено.
Когда имя не задано, при первом старте демон создаёт запоминающееся название, например my-machine-distant-plume. Посмотреть текущее имя можно с помощью agy remote-control status. Название также разрешается изменить в файле настроек: откройте ~/.gemini/config/config.json в Linux или macOS либо %USERPROFILE%\.gemini\config\config.json в Windows, отредактируйте cliRemoteControlHostname, сохраните файл и снова запустите agy remote-control start. Новое название отобразится на панели после перезапуска службы. Пока демон работает, изменения в файле не применяются.
В конфигурации есть два сходных параметра. cliRemoteControlHostname задаёт имя демона CLI. Поле remoteControlHostname относится к настольному редактору Antigravity на том же компьютере; в версии Antigravity 2.0 его можно изменить через Settings → App.
Работа демона после выхода из системы и перезапуска компьютера
Результат зависит от операционной системы:
| Поведение | Linux | macOS | Windows |
|---|---|---|---|
| Запуск | При загрузке системы; входить в учётную запись не требуется | При входе пользователя в систему | При загрузке, если служба установлена администратором; в остальных случаях — при входе |
| Работа после выхода из системы | Да | Нет, работа возобновится при следующем входе | Да, если настроен запуск при загрузке |
| Автоматическое восстановление после сбоя | Да | Да | Да, демон перезапускается до трёх раз, затем — при следующей загрузке или повторном запуске agy remote-control start |
Особенности Windows
Чтобы зарегистрировать демон для автоматического запуска при загрузке системы, команду нужно выполнить с правами администратора. Подойдут PowerShell и обычная командная строка. Команда start, запущенная в обычном окне, также сработает, однако после выхода из системы или перезагрузки демон запустится только при следующем входе пользователя, а не во время загрузки компьютера. Команды status и stop можно выполнять из обычного окна без повышенных прав.
Выбор режима
| Критерий | Интерактивный (/remote-control / agy --remote-control) | Headless-демон (agy remote-control start) |
|---|---|---|
| Область действия | Один интерактивный сеанс терминала | Весь компьютер; работает как фоновая служба ОС |
| Период работы | Пока Remote Control включён и активен процесс терминала | Сохраняется после выхода из системы и перезагрузки в Linux, а также в Windows при установке с правами администратора; в macOS и при обычной установке Windows возобновляется при следующем входе пользователя |
| Имя записи | Создаётся заново для каждой сессии, например host-swift-falcon | Постоянное имя компьютера, заданное через --name или cliRemoteControlHostname |
| Одновременные подключения | На одном компьютере можно запустить несколько терминальных сессий | На один компьютер приходится одна служба демона |
| Прямая ссылка | CLI выводит ссылку на открытый диалог | Подключение выполняется через список устройств на antigravity.google.com |
| Подходящий сценарий | Нужно отойти от текущей задачи в терминале и продолжить со смартфона или через браузер | Требуется постоянный удалённый доступ к рабочей станции или серверу, пока компьютер включён и подключён к интернету, с учётом особенностей ОС |
Для доступа со смартфона к текущей задаче достаточно интерактивного режима. Если требуется подключаться без открытого терминала, настройте headless-демон с учётом правил для вашей операционной системы.
Устранение проблем с подключением
Ниже собраны рекомендации из официальной документации:
| Симптом | Возможная причина | Решение |
|---|---|---|
Remote control is not enabled for your account | Политика аккаунта или организации не разрешает Remote Control | Обратитесь к администратору рабочего пространства или уточните, входит ли Remote Control в ваш тарифный план |
| Запись CLI исчезает с панели управления | /remote-control и agy --remote-control создают туннели, которые закрываются при завершении интерактивной сессии (/exit, Ctrl+C) или после команды /remote-control off | Чтобы компьютер оставался доступен без открытого терминала, установите headless-демон командой agy remote-control start |
| На панели несколько записей CLI для одного компьютера | У каждого интерактивного CLI-сеанса своё имя хоста; несколько открытых терминалов создают отдельные записи | Дополнительных действий не требуется: это предусмотрено режимом работы |
| Демон не показывает компьютер на панели управления | Возможны проблемы с авторизацией CLI | Запустите agy remote-control status. Если команда сообщает об ошибке входа, выполните agy, авторизуйтесь снова, затем повторите agy remote-control start |
| Новое имя не отображается | Демон считывает имя во время запуска | Повторно выполните agy remote-control start, чтобы перезапустить службу |
| В Windows демон запускается при входе пользователя, но не при загрузке | Команду start выполнили без прав администратора | Запустите agy remote-control start повторно из окна с повышенными правами |
| Соединение постоянно обрывается и восстанавливается | Старый демон, установленный сценарием установки, может оставаться зарегистрированным и конкурировать с новым за соединение | Снова запустите agy remote-control start; старая служба удалится автоматически |
| На панели видны две похожие записи одного компьютера | Одна запись относится к редактору, другая — к демону CLI; они отображаются отдельно | Измените имя записи, которую требуется различать |
| Настольный компьютер не отображается в браузере | Переключатель может быть выключен, отсутствует интернет, компьютер спит или аккаунты Google различаются | Проверьте Enable Remote Control, соединение компьютера с интернетом, режим сна и совпадение аккаунта в приложении и браузере |
Для подробной диагностики доступны журналы демона: в Linux используйте journalctl --user -u antigravity-cli-daemon -n 50; в macOS откройте ~/Library/Logs/antigravity-cli-daemon.log; в Windows найдите самый новый файл cli-*.log в %USERPROFILE%\.gemini\antigravity-cli\log.
Headless-демон позволяет подключаться без открытого терминала, в том числе когда вас нет рядом с компьютером, при соблюдении условий для машины и операционной системы. Когда постоянный доступ больше не требуется, остановите службу командой agy remote-control stop.
Отдельная инструкция посвящена удалённому управлению Claude Code. Если нужно управлять другим агентом через Telegram, воспользуйтесь материалом о настройке Hermes Agent в Telegram.
Следующие шаги
Если вы работаете в CLI и хотите ненадолго отойти от текущей задачи, включите интерактивный режим. Оставьте окно терминала открытым: после его закрытия туннель завершится, а запись сессии исчезнет с панели управления. Для доступа без открытого терминала настройте демон, учитывая ограничения своей ОС.
Источники
Дополнительные материалы доступны на Ailoot.
Подробнее
Вопросы и ответы
Почему удалённая сессия исчезает после закрытия терминала?
Интерактивный Remote Control принадлежит работающему процессу agy: его завершение закрывает туннель. Для доступа без открытого терминала используйте фоновый демон и проверьте условия его запуска в ОС.
Что проверить, если машина отсутствует в панели?
Проверьте, что она включена, доступна в сети, Remote Control включён, а браузер использует тот же Google-аккаунт, что приложение или CLI. Для демона проверьте agy remote-control status на проблемы входа и службы.