Блог

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

Активируйте удалённое управление в параметрах приложения:

  1. Откройте Settings сочетанием Cmd + , (на Linux и Windows — Ctrl + ,) либо нажмите Settings в нижней части левой панели.
  2. Выберите раздел App.
  3. Переведите переключатель Enable Remote Control в состояние On.
  4. (По желанию) Укажите Nickname, например workstation-primary или server-machine, чтобы проще находить компьютер среди подключённых устройств.

Подключение со смартфона или через другой браузер

Для доступа к удалённой сессии выполните следующие действия:

  1. Откройте браузер на нужном устройстве и перейдите на панель управления Antigravity Remote Control. На смартфоне веб-приложение можно добавить на главный экран; тогда будут приходить push-уведомления о завершении задачи агентом или запросе ответа.
  2. Авторизуйтесь в том же Google-аккаунте, который используется на компьютере.
  3. В списке устройств выберите нужную машину.
  4. После соединения отобразятся активные диалоги. Можно поручать агенту новые задачи, изучать планы их выполнения и просматривать артефакты.

Если компьютер не отображается в веб-интерфейсе, официальная инструкция рекомендует проверить следующее: на компьютере с 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.

Работа демона после выхода из системы и перезапуска компьютера

Результат зависит от операционной системы:

ПоведениеLinuxmacOSWindows
ЗапускПри загрузке системы; входить в учётную запись не требуетсяПри входе пользователя в системуПри загрузке, если служба установлена администратором; в остальных случаях — при входе
Работа после выхода из системыДаНет, работа возобновится при следующем входеДа, если настроен запуск при загрузке
Автоматическое восстановление после сбояДаДаДа, демон перезапускается до трёх раз, затем — при следующей загрузке или повторном запуске 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 на проблемы входа и службы.

Все статьи