Antigravity Remote Control : piloter l’agent sur téléphone
MarkdownComment activer Remote Control dans Google Antigravity sur ordinateur et dans la CLI : le bouton, le démon agy remote-control et les solutions aux problèmes de connexion.
Lire l’article complet
Documentation Ailoot — ressources de référence sur l’utilisation du service.
À retenir
Dans Antigravity 2.0 pour ordinateur, Remote Control s’active à l’aide d’un bouton dans Settings → App. Vous pouvez vous connecter à une session sur antigravity.google.com avec le même compte Google. Antigravity CLI propose deux modes : /remote-control (ou l’option --remote-control) ouvre un tunnel pendant toute la durée de la session du terminal, tandis que agy remote-control start lance un démon en arrière-plan sans terminal ouvert. Sous Linux, le démon continue de fonctionner après votre déconnexion et démarre après un redémarrage ; sous Windows, son installation nécessite des droits d’administrateur ; sous macOS et avec une installation standard de Windows, il reprend au prochain login. L’ordinateur doit être allumé et connecté à Internet. La fonctionnalité peut être indisponible en raison des règles du compte ou de l’organisation, ou des conditions du forfait.
Si vous n’avez pas encore installé Antigravity, commencez par un aperçu de Google Antigravity et de son installation. Ce guide s’adresse à celles et ceux dont l’agent est déjà occupé à une tâche de longue durée (refactorisation, exécution de tests, migration de dépendances) et qui doivent s’éloigner de leur bureau tout en gardant le contrôle de la session.
À quoi sert Remote Control dans Google Antigravity ?
Remote Control est une fonctionnalité de Google Antigravity qui vous permet de vous connecter en toute sécurité aux sessions de bureau et CLI sur vos machines et de les contrôler depuis n’importe quel navigateur Web. D’après la description officielle, les tâches importantes — par exemple, la refactorisation complète d’un sous-système, une longue série de tests ou une migration complexe de dépendances — peuvent prendre beaucoup de temps. Remote Control vous permet de gérer une session loin de votre ordinateur, tout en gardant votre environnement de développement entièrement en local.
La fonctionnalité est disponible dans l’application de bureau 2.0 et dans la CLI — la version d’Antigravity pour terminal (agy) — mais son activation et son fonctionnement diffèrent selon le mode.
Activer Remote Control dans Antigravity 2.0 pour ordinateur
Vous pouvez activer Remote Control dans les paramètres de l’application :
- Ouvrez le panneau Settings avec
Cmd + ,(ouCtrl + ,sous Linux et Windows), ou cliquez sur le bouton Settings en bas du panneau de gauche. - Accédez à la section App.
- Réglez Enable Remote Control sur On.
- (Facultatif) Définissez un Nickname, par exemple
workstation-primaryouserver-machine, afin de reconnaître facilement cette machine dans la liste des appareils connectés.
Se connecter depuis un téléphone ou un autre navigateur
Pour ouvrir une session à distance :
- Ouvrez un navigateur sur n’importe quel appareil et accédez au tableau de bord Antigravity Remote Control. Sur un téléphone, vous pouvez aussi installer l’application Web sur votre écran d’accueil pour recevoir une notification push lorsque l’agent termine une tâche ou attend votre réponse.
- Connectez-vous avec le même compte Google que celui utilisé sur l’ordinateur.
- Sélectionnez la machine souhaitée dans le sélecteur d’appareils.
- Une fois connecté, vous pouvez consulter les conversations actives, lancer de nouvelles tâches pour l’agent et voir les plans d’implémentation et les artefacts.
Si la machine ne s’affiche pas dans l’interface Web, les instructions officielles recommandent de vérifier trois points : le bouton Enable Remote Control est activé sur l’ordinateur qui exécute Antigravity ; cet ordinateur est connecté à Internet et n’est pas en veille ; l’application de bureau et le navigateur utilisent le même compte Google.
Si la connexion réseau est temporairement interrompue sur l’appareil utilisé pour se connecter, l’interface Web tentera de se reconnecter automatiquement. Les tâches en arrière-plan de l’agent et les commandes lancées depuis le terminal continuent de s’exécuter sur l’ordinateur équipé d’Antigravity sans interruption, tant qu’il reste connecté à Internet.
Les deux modes Remote Control dans Antigravity CLI
La CLI propose deux modes : un mode interactif lié à un processus de terminal spécifique et un démon sans interface en arrière-plan qui fonctionne sans terminal ouvert.
Mode interactif : /remote-control
Vous pouvez activer Remote Control dans la session interactive agy en cours sans redémarrer la CLI. Exécutez cette commande sur la ligne de saisie :
/remote-control
D’après la description officielle, la CLI ouvre une connexion — un tunnel inversé — pour la session en cours, puis affiche le nom d’hôte et un lien vers la conversation active, accessible depuis un autre appareil :
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.
Ouvrez ce lien dans un navigateur sur un ordinateur portable, une tablette ou un téléphone, connectez-vous avec le même compte Google que celui utilisé dans la CLI, puis poursuivez la session dans l’interface Web d’Antigravity.
Pour désactiver le tunnel sans mettre fin à la session du terminal local :
/remote-control off
Vous pouvez démarrer la CLI avec Remote Control déjà activé en ajoutant une option au lancement :
agy --remote-control
Le mode interactif est lié au processus agy : lorsque vous quittez la CLI (/exit, Ctrl+C, Ctrl+D) ou fermez la fenêtre du terminal, le tunnel Remote Control prend fin automatiquement et l’entrée de la session disparaît du tableau de bord. Chaque processus CLI interactif possède son propre identifiant de session et son propre nom d’hôte ; vous pouvez donc exécuter agy --remote-control simultanément dans plusieurs onglets de terminal ou répertoires de travail.
Lorsque vous vous connectez depuis un navigateur à une session CLI interactive, les deux côtés se synchronisent en temps réel. Les requêtes de l’appareil distant sont transmises directement au terminal local, tandis que le raisonnement de l’agent, ses appels d’outils et ses modifications de code sont visibles dans l’interface distante. Si l’agent s’arrête pour demander une confirmation (y/n) ou pose une question complémentaire, vous pouvez répondre depuis votre téléphone ou le terminal local. Les paramètres font exception : vous ne pouvez pas les modifier depuis l’interface Web distante, uniquement depuis la CLI.
Démon sans interface : agy remote-control start
Le second mode est un démon persistant en arrière-plan, enregistré comme service du système d’exploitation. Il est disponible lorsque la machine est allumée et connectée à Internet ; son fonctionnement après une déconnexion ou un redémarrage dépend de la plateforme.
agy remote-control start
Le démon s’enregistre comme service du système d’exploitation (un service utilisateur systemd sous Linux, un LaunchAgent sous macOS ou une tâche planifiée sous Windows) et démarre immédiatement, sans fenêtre de terminal ouverte.
Utilisez agy remote-control status pour afficher le nom de l’entrée. Sélectionnez ensuite cette machine dans le tableau de bord Antigravity Remote Control et poursuivez votre travail dans l’interface Web d’Antigravity.
Trois commandes permettent de contrôler le démon :
agy remote-control start Enregistrer et démarrer le démon
agy remote-control status Afficher l’état du démon et le nom de l’instance
agy remote-control stop Arrêter le démon et le désenregistrer
Le démon utilise les identifiants employés pour se connecter à la CLI. La connexion à la CLI est distincte de la connexion à l’éditeur Antigravity pour ordinateur sur la même machine ; dans le navigateur, utilisez le même compte Google que dans la CLI.
Vous pouvez définir le nom de la machine du démon sans interface à l’aide de l’option --name au démarrage :
agy remote-control start --name "my-workstation"
Exécuter de nouveau start --name avec une nouvelle valeur renomme la machine.
Si vous ne définissez pas de nom, le démon en génère un facile à retenir (par exemple, my-machine-distant-plume) lors de son premier lancement ; agy remote-control status affiche le nom actuel. Vous pouvez également le renommer dans le fichier de paramètres : ouvrez ~/.gemini/config/config.json sous Linux/macOS ou %USERPROFILE%\.gemini\config\config.json sous Windows, modifiez la valeur de cliRemoteControlHostname, enregistrez le fichier et exécutez de nouveau agy remote-control start pour redémarrer le démon. Le nouveau nom apparaîtra dans le tableau de bord après le redémarrage du service ; les modifications du fichier ne prennent pas effet tant que le démon fonctionne.
Le fichier contient deux champs similaires. cliRemoteControlHostname est le nom du démon CLI concerné ici. remoteControlHostname est un champ distinct qui concerne l’éditeur Antigravity pour ordinateur sur la même machine ; dans Antigravity 2.0, vous pouvez le modifier dans Settings → App.
Fonctionnement du démon après une déconnexion et un redémarrage
Le fonctionnement dépend du système d’exploitation :
| Fonctionnement | Linux | macOS | Windows |
|---|---|---|---|
| Démarrage | Au démarrage de la machine ; aucune connexion requise | À la connexion | Au démarrage de la machine (si l’installation est effectuée par un administrateur) ; sinon, à la connexion |
| Fonctionne après la déconnexion | Oui | Non ; reprend à la prochaine connexion | Oui, s’il est configuré pour démarrer au démarrage de la machine |
| Redémarrage automatique après une panne | Oui | Oui | Oui, jusqu’à trois tentatives de redémarrage, puis au prochain démarrage ou lors d’une nouvelle exécution de agy remote-control start |
Détails propres à Windows
L’enregistrement du démon pour qu’il démarre automatiquement au démarrage du système nécessite des droits d’administrateur. Vous pouvez utiliser PowerShell ou l’invite de commandes habituelle. La commande start fonctionne aussi dans une fenêtre normale, mais après une déconnexion ou un redémarrage, le démon ne reprendra qu’à la prochaine connexion, et non au démarrage. Les commandes status et stop fonctionnent dans une fenêtre normale sans privilèges élevés.
Quel mode choisir ?
| Critère | Mode interactif (/remote-control / agy --remote-control) | Démon sans interface (agy remote-control start) |
|---|---|---|
| Portée | Une session de terminal interactive | Toute la machine (service du système d’exploitation en arrière-plan) |
| Cycle de vie | Actif lorsque Remote Control est activé et que la session du terminal est en cours | Persiste après une déconnexion et des redémarrages sous Linux et sous Windows lorsqu’il est installé par un administrateur ; sous macOS et avec une installation standard de Windows, reprend à la prochaine connexion |
| Nom de l’entrée | Nouveau pour chaque session (par exemple, host-swift-falcon) | Un nom permanent pour la machine (--name ou cliRemoteControlHostname) |
| Exécution simultanée | Plusieurs sessions de terminal à la fois sur une machine | Un service démon par machine |
| Lien direct | La CLI affiche un lien vers la conversation active | Accès via le sélecteur d’appareils sur antigravity.google.com |
| Idéal pour | S’éloigner d’une tâche en cours dans le terminal et la poursuivre depuis un téléphone ou un navigateur | Accès distant persistant à un poste de travail ou à un serveur lorsque la machine est allumée et connectée à Internet, sous réserve des conditions du système d’exploitation |
Le mode interactif suffit pour gérer une tâche en cours depuis votre téléphone. Si vous avez besoin d’un accès distant sans terminal ouvert, utilisez le démon sans interface, sous réserve des conditions de votre système d’exploitation.
Que faire en cas de problèmes de connexion ?
Problèmes et solutions tirés de la documentation officielle :
| Ce que vous voyez | Pourquoi | Que faire |
|---|---|---|
Remote control is not enabled for your account | Votre compte ou les règles de votre organisation n’autorisent pas la fonctionnalité Remote Control | Contactez l’administrateur de votre espace de travail ou vérifiez si votre forfait prend en charge Remote Control |
| L’entrée disparaît du tableau de bord (CLI) | /remote-control et agy --remote-control créent des tunnels qui se déconnectent automatiquement lorsque vous quittez la session interactive (/exit, Ctrl+C) ou exécutez /remote-control off | Si vous avez besoin que la machine reste accessible sans terminal ouvert, installez le démon sans interface avec agy remote-control start |
| Plusieurs entrées CLI de la même machine apparaissent dans le tableau de bord | Chaque session CLI interactive a son propre nom d’hôte ; c’est normal lorsque plusieurs terminaux sont ouverts | Aucune action n’est nécessaire ; ce comportement est attendu |
| La machine n’apparaît pas dans le tableau de bord (démon) | La connexion à la CLI peut poser problème | Exécutez agy remote-control status ; si une erreur de connexion est signalée, exécutez agy, connectez-vous de nouveau, puis relancez agy remote-control start |
| Le changement de nom n’a pas pris effet | Le nom est lu au démarrage du démon | Exécutez de nouveau agy remote-control start pour redémarrer le démon |
| Sous Windows, le démon démarre à la connexion, mais pas au démarrage de la machine | La commande start a été exécutée sans droits d’administrateur | Exécutez de nouveau agy remote-control start depuis une fenêtre avec élévation de privilèges |
| La connexion est interrompue et rétablie sans cesse | Un ancien démon installé par le script d’installation est peut-être toujours enregistré et entre en concurrence avec le nouveau pour la connexion | Exécutez de nouveau agy remote-control start ; l’ancien service est supprimé automatiquement |
| Deux entrées similaires d’une même machine apparaissent dans le tableau de bord | L’une correspond à l’éditeur, l’autre au démon CLI ; elles sont volontairement distinctes | Renommez l’entrée que vous souhaitez distinguer |
| La machine n’apparaît pas dans le tableau de bord Web (ordinateur) | Le bouton est peut-être désactivé, il n’y a peut-être pas de connexion Internet, l’ordinateur est peut-être en veille ou des comptes Google différents sont utilisés | Vérifiez que le bouton Enable Remote Control est activé, que l’ordinateur est connecté à Internet et n’est pas en veille, et que le même compte est utilisé des deux côtés |
Pour effectuer des diagnostics plus poussés, consultez les journaux du démon : sous Linux, exécutez journalctl --user -u antigravity-cli-daemon -n 50 ; sous macOS, consultez ~/Library/Logs/antigravity-cli-daemon.log ; sous Windows, consultez le fichier cli-*.log le plus récent dans %USERPROFILE%\.gemini\antigravity-cli\log.
Le démon sans interface donne accès à la machine sans terminal ouvert, y compris lorsque vous êtes absent, sous réserve des conditions de fonctionnement de l’ordinateur et du système d’exploitation. Si vous n’avez plus besoin d’un accès persistant, arrêtez le démon avec agy remote-control stop.
Un article distinct porte sur le contrôle à distance dans Claude Code. Pour contrôler un autre agent via Telegram, consultez la configuration de Hermes Agent dans Telegram.
Et ensuite ?
Si vous travaillez dans la CLI et souhaitez vous éloigner de la tâche en cours, commencez par le mode interactif. Laissez le terminal ouvert : si vous le fermez, le tunnel se déconnecte et l’entrée de la session disparaît du tableau de bord. Pour accéder à la machine sans terminal ouvert, utilisez le démon, sous réserve des limites de votre système d’exploitation.
Sources
Retrouvez d’autres ressources sur Ailoot.
Plus de détails
Questions fréquentes : Antigravity Remote Control : piloter l’agent sur téléphone
Pourquoi la session distante disparaît-elle quand je ferme le terminal ?
Remote Control interactif appartient au processus agy actif ; le quitter ferme le tunnel. Pour un accès sans terminal ouvert, utilisez le démon sans interface et vérifiez ses conditions de démarrage système.
Que vérifier si ma machine manque dans le tableau de bord ?
Vérifiez qu’elle est éveillée, en ligne et avec Remote Control activé, puis que le navigateur utilise le même compte Google que Desktop ou le CLI. Pour le démon, inspectez agy remote-control status pour les erreurs de service ou de connexion.