Blog

Google Antigravity Remote Control: cómo controlar el agente desde el teléfono

Markdown

Cómo activar Remote Control en Google Antigravity para escritorio y en la CLI: el interruptor, el daemon agy remote-control y qué hacer si tienes problemas de conexión.

Leer el artículo completo

Documentación de Ailoot — materiales de referencia sobre el uso del servicio.

Puntos destacados

En Antigravity 2.0 para escritorio, Remote Control se activa con un interruptor en Settings → App. Puedes conectarte a una sesión en antigravity.google.com con la misma cuenta de Google. Antigravity CLI tiene dos modos: /remote-control (o la opción --remote-control) abre un túnel mientras dura la sesión del terminal, mientras que agy remote-control start inicia un daemon en segundo plano sin un terminal abierto. En Linux, el daemon sigue funcionando después de cerrar sesión y se inicia tras reiniciar el equipo; en Windows, es necesario que lo instale un administrador; en macOS y en una instalación estándar de Windows, se reanuda en el siguiente inicio de sesión. El ordenador debe estar encendido y conectado a Internet. Es posible que la función no esté disponible debido a las políticas de la cuenta o de la organización, o a las condiciones del plan.

Si todavía no has instalado Antigravity, empieza por una introducción a qué es Google Antigravity y cómo instalarlo. Esta guía está pensada para cuando un agente ya está realizando una tarea larga (refactorización, ejecución de pruebas o migración de dependencias) y necesitas alejarte del escritorio sin perder el control de la sesión.

¿Qué es Remote Control y para qué sirve?

Remote Control es una función de Google Antigravity que te permite conectarte de forma segura a sesiones de escritorio y de CLI en tus máquinas y controlarlas desde cualquier navegador web. Según la descripción oficial, las tareas grandes —por ejemplo, refactorizar por completo un subsistema, ejecutar pruebas durante mucho tiempo o realizar una migración compleja de dependencias— pueden llevar mucho tiempo. Remote Control te permite gestionar una sesión mientras estás lejos del ordenador y mantener todo tu entorno de desarrollo en local.

La función está disponible tanto en la aplicación de escritorio 2.0 como en la CLI —la versión de Antigravity para terminal (agy)—, pero se activa y funciona de forma distinta en cada una.

Activar Remote Control en Antigravity 2.0 para escritorio

Puedes activar Remote Control en los ajustes de la aplicación:

  1. Abre el panel Settings con Cmd + , (o Ctrl + , en Linux y Windows), o haz clic en el botón Settings en la parte inferior del panel izquierdo.
  2. Ve a la sección App.
  3. Cambia Enable Remote Control a On.
  4. (Opcional) Define un Nickname, como workstation-primary o server-machine, para identificar fácilmente esta máquina en la lista de dispositivos conectados.

Conectarse desde un teléfono u otro navegador

Para abrir una sesión remota:

  1. Abre un navegador en cualquier dispositivo y ve al panel de control de Antigravity Remote Control. En un teléfono, también puedes instalar la aplicación web en la pantalla de inicio para recibir notificaciones push cuando el agente termine una tarea o te pida una respuesta.
  2. Inicia sesión con la misma cuenta de Google que usas en el ordenador.
  3. Selecciona la máquina que quieras en el selector de dispositivos.
  4. Una vez conectado, podrás ver las conversaciones activas, iniciar nuevas tareas para el agente y consultar los planes de implementación y los artefactos.

Si la máquina no aparece en la interfaz web, las instrucciones oficiales recomiendan comprobar tres cosas: que el interruptor Enable Remote Control esté activado en el ordenador que ejecuta Antigravity; que el ordenador tenga conexión a Internet y no esté en reposo; y que la aplicación de escritorio y el navegador usen la misma cuenta de Google.

Si la conexión de red se interrumpe temporalmente en el dispositivo que usas para conectarte, la interfaz web intentará reconectarse automáticamente. Las tareas en segundo plano del agente y los comandos iniciados desde el terminal seguirán ejecutándose en el ordenador con Antigravity sin interrupciones, siempre que permanezca conectado a Internet.

Diagrama: el interruptor Remote Control de un portátil transfiere el control a un teléfono cuando ambos han iniciado sesión con la misma cuenta
Cómo funciona Remote Control en el ordenador: activa el interruptor en el ordenador y, después, inicia sesión desde el teléfono con la misma cuenta de Google.

Los dos modos de Remote Control en Antigravity CLI

La CLI tiene dos modos: un modo interactivo vinculado a un proceso concreto del terminal y un daemon sin interfaz en segundo plano que funciona sin un terminal abierto.

Modo interactivo: /remote-control

Puedes activar Remote Control en la sesión interactiva de agy actual sin reiniciar la CLI. Ejecuta esto en la línea de entrada:

/remote-control

Según la descripción oficial, la CLI abre una conexión —un túnel inverso— para la sesión actual e imprime el nombre de host junto con un enlace a la conversación activa para usar desde otro dispositivo:

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.

Abre este enlace en un navegador de un portátil, una tableta o un teléfono, inicia sesión con la misma cuenta de Google que usas en la CLI y continúa trabajando en la sesión desde la interfaz web de Antigravity.

Para desactivar el túnel sin finalizar la sesión del terminal local:

/remote-control off

Puedes iniciar la CLI con Remote Control ya activado usando una opción al arrancar:

agy --remote-control

El modo interactivo está vinculado al proceso agy: cuando sales de la CLI (/exit, Ctrl+C, Ctrl+D) o cierras la ventana del terminal, el túnel de Remote Control termina automáticamente y la entrada de la sesión desaparece del panel de control. Cada proceso interactivo de la CLI tiene su propio ID de sesión y nombre de host, por lo que puedes ejecutar agy --remote-control al mismo tiempo en varias pestañas del terminal o directorios de trabajo.

Cuando te conectas desde un navegador a una sesión interactiva de la CLI, ambos lados se sincronizan en tiempo real. Las solicitudes del dispositivo remoto llegan directamente al terminal local, mientras que el razonamiento del agente, las llamadas a herramientas y los cambios de código se muestran en la interfaz remota. Si el agente se detiene para pedir confirmación (y/n) o hace una pregunta de seguimiento, puedes responder desde el teléfono o desde el terminal local. Los ajustes son la excepción: no puedes modificarlos desde la interfaz web remota, solo desde la propia CLI.

Daemon sin interfaz: agy remote-control start

El segundo modo es un daemon persistente en segundo plano que se registra como servicio del sistema operativo. Está disponible mientras la máquina esté encendida y conectada a Internet; su comportamiento al cerrar sesión y al reiniciar depende de la plataforma.

agy remote-control start

El daemon se registra como servicio del sistema operativo (un servicio de usuario de systemd en Linux, un LaunchAgent en macOS o una tarea programada en Windows) y se inicia inmediatamente, sin una ventana del terminal abierta.

Usa agy remote-control status para ver el nombre de la entrada. Después selecciona esta máquina en el panel de control de Antigravity Remote Control y sigue trabajando desde la interfaz web de Antigravity.

Hay tres comandos para controlar el daemon:

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

El daemon usa las credenciales con las que iniciaste sesión en la CLI. Iniciar sesión en la CLI es independiente de iniciar sesión en el editor de escritorio Antigravity en la misma máquina; en el navegador, usa la misma cuenta de Google que en la CLI.

Puedes definir el nombre de la máquina del daemon sin interfaz con la opción --name al iniciarlo:

agy remote-control start --name "my-workstation"

Si vuelves a ejecutar start --name con un valor nuevo, se cambiará el nombre de la máquina.

Si no defines un nombre, el daemon genera uno fácil de recordar (como my-machine-distant-plume) la primera vez que se inicia; agy remote-control status muestra el nombre actual. También puedes cambiarlo en el archivo de ajustes: abre ~/.gemini/config/config.json en Linux/macOS o %USERPROFILE%\.gemini\config\config.json en Windows, cambia el valor de cliRemoteControlHostname, guarda el archivo y vuelve a ejecutar agy remote-control start para reiniciar el daemon. El nuevo nombre aparecerá en el panel de control cuando se reinicie el servicio; los cambios en el archivo no surten efecto mientras el daemon está en funcionamiento.

El archivo contiene dos campos parecidos. cliRemoteControlHostname es el nombre del daemon de la CLI del que hablamos aquí. remoteControlHostname es un campo independiente para el editor de escritorio Antigravity de la misma máquina; en Antigravity 2.0, puedes cambiarlo en Settings → App.

Comportamiento del daemon al cerrar sesión y reiniciar

El comportamiento depende del sistema operativo:

ComportamientoLinuxmacOSWindows
InicioAl arrancar; no es necesario iniciar sesiónAl iniciar sesiónAl arrancar (si lo instala un administrador); de lo contrario, al iniciar sesión
Sigue funcionando al cerrar sesiónSíNo; se reanuda en el siguiente inicio de sesiónSí, si está configurado para iniciarse al arrancar
Se recupera automáticamente tras un falloSíSíSí, hasta tres intentos de reinicio; después, en el siguiente arranque o al volver a ejecutar agy remote-control start

Detalles específicos de Windows

Para registrar el daemon de modo que se inicie automáticamente al arrancar el sistema, es necesario ejecutar el proceso como administrador. Puedes usar PowerShell o el símbolo del sistema habitual. El comando start también funciona desde una ventana normal, pero tras cerrar sesión o reiniciar, el daemon solo se reanudará en el siguiente inicio de sesión, no al arrancar el equipo. Los comandos status y stop funcionan desde una ventana normal sin privilegios elevados.

Qué modo elegir

CriterioInteractivo (/remote-control / agy --remote-control)Daemon sin interfaz (agy remote-control start)
AlcanceUna sesión interactiva del terminalToda la máquina (servicio del sistema operativo en segundo plano)
Ciclo de vidaActivo mientras Remote Control esté habilitado y la sesión del terminal siga en ejecuciónSobrevive al cierre de sesión y a los reinicios en Linux y en Windows cuando lo instala un administrador; en macOS y en una instalación estándar de Windows, se reanuda en el siguiente inicio de sesión
Nombre de la entradaNuevo para cada sesión (por ejemplo, host-swift-falcon)Un nombre permanente para la máquina (--name o cliRemoteControlHostname)
SimultaneidadVarias sesiones de terminal a la vez en una máquinaUn servicio daemon por máquina
Enlace directoLa CLI imprime un enlace a la conversación activaAcceso mediante el selector de dispositivos en antigravity.google.com
Ideal paraAlejarte de una tarea activa en el terminal y continuar desde un teléfono o navegadorAcceso remoto persistente a una estación de trabajo o servidor mientras la máquina esté encendida y conectada a Internet, sujeto a las condiciones del sistema operativo

El modo interactivo basta para gestionar una tarea en curso desde el teléfono. Si necesitas acceso remoto sin un terminal abierto, usa el daemon sin interfaz, sujeto a las condiciones de tu sistema operativo.

Diagrama: el túnel de la sesión desaparece al cerrar el terminal; el daemon en segundo plano funciona sin un terminal abierto
Diferencia entre los modos de CLI: el túnel interactivo funciona solo mientras el terminal está abierto; el daemon sin interfaz funciona sin un terminal abierto (sujeto a las condiciones del sistema operativo indicadas en la tabla anterior).

Qué hacer si tienes problemas de conexión

Problemas y soluciones de la documentación oficial:

Qué vesPor quéQué hacer
Remote control is not enabled for your accountLas políticas de tu cuenta o de tu organización no han habilitado la función Remote ControlPonte en contacto con el administrador de tu espacio de trabajo o comprueba si tu plan es compatible con Remote Control
La entrada desaparece del panel de control (CLI)/remote-control y agy --remote-control crean túneles que se desconectan automáticamente al salir de la sesión interactiva (/exit, Ctrl+C) o ejecutar /remote-control offSi necesitas que la máquina siga disponible sin un terminal abierto, instala el daemon sin interfaz con agy remote-control start
Aparecen varias entradas de CLI de la misma máquina en el panel de controlCada sesión interactiva de la CLI tiene su propio nombre de host; esto es normal si hay varios terminales abiertosNo hace falta hacer nada; es el comportamiento esperado
La máquina no aparece en el panel de control (daemon)Puede haber un problema con el inicio de sesión en la CLIEjecuta agy remote-control status; si indica un problema de inicio de sesión, ejecuta agy, inicia sesión de nuevo y, después, vuelve a ejecutar agy remote-control start
El cambio de nombre no surtió efectoEl nombre se lee cuando se inicia el daemonVuelve a ejecutar agy remote-control start para reiniciar el daemon
En Windows, el daemon solo se inicia al iniciar sesión, no al arrancar el equipoEl comando start se ejecutó sin privilegios de administradorVuelve a ejecutar agy remote-control start desde una ventana con privilegios elevados
La conexión se interrumpe y se restablece continuamentePuede que siga registrado un daemon antiguo instalado mediante el script de instalación y que compita con el nuevo por la conexiónVuelve a ejecutar agy remote-control start; el servicio antiguo se elimina automáticamente
Aparecen dos entradas parecidas de una máquina en el panel de controlUna entrada corresponde al editor y la otra al daemon de la CLI; son distintas a propósitoCambia el nombre de la que necesites distinguir
La máquina no aparece en el panel de control web (escritorio)Es posible que el interruptor esté desactivado, que no haya conexión a Internet, que el ordenador esté en reposo o que se estén usando cuentas de Google distintasComprueba que el interruptor Enable Remote Control esté activado, que el ordenador tenga conexión a Internet y no esté en reposo, y que se use la misma cuenta en ambos lados

Para realizar diagnósticos más detallados, consulta los registros del daemon: en Linux, ejecuta journalctl --user -u antigravity-cli-daemon -n 50; en macOS, consulta ~/Library/Logs/antigravity-cli-daemon.log; en Windows, consulta el archivo cli-*.log más reciente en %USERPROFILE%\.gemini\antigravity-cli\log.

El daemon sin interfaz permite acceder a la máquina sin un terminal abierto, incluso cuando estás fuera, sujeto a las condiciones de funcionamiento del ordenador y del sistema operativo. Si ya no necesitas un acceso persistente, detén el daemon con agy remote-control stop.

Hay un artículo aparte sobre el control remoto en Claude Code. Para controlar otro agente a través de Telegram, consulta cómo configurar Hermes Agent en Telegram.

Qué hacer a continuación

Si trabajas en la CLI y quieres alejarte de la tarea en curso, empieza con el modo interactivo. Deja el terminal abierto: si lo cierras, el túnel se desconectará y la entrada de la sesión desaparecerá del panel de control. Para acceder a la máquina sin un terminal abierto, usa el daemon, sujeto a las limitaciones de tu sistema operativo.

Encontrarás más materiales en Ailoot.

Más detalles

Preguntas sobre Antigravity

¿Por qué desaparece la sesión remota al cerrar la terminal?

Remote Control interactivo pertenece al proceso agy en marcha; salir de él cierra el túnel. Para acceder sin terminal abierta, utiliza el daemon sin interfaz y comprueba sus condiciones de arranque en el sistema operativo.

¿Qué compruebo si mi equipo no aparece en el dashboard?

Que esté despierto y conectado, que Remote Control esté activado y que el navegador use la misma cuenta Google que Desktop o la CLI. Para una sesión daemon, consulta agy remote-control status por si hay problemas de inicio de sesión o servicio.

Todos los artículos