Google Antigravity Remote Control: come controllare l'agente dal telefono
MarkdownCome abilitare Remote Control in Google Antigravity su desktop e nella CLI: l'interruttore, il daemon agy remote-control e cosa fare in caso di problemi di connessione.
Leggi l’articolo completo
Documentazione Ailoot — materiali di riferimento sull'utilizzo del servizio.
In breve
In Antigravity 2.0 desktop, Remote Control si abilita con un interruttore in Settings → App. Puoi collegarti a una sessione su antigravity.google.com usando lo stesso account Google. Antigravity CLI dispone di due modalità: /remote-control (o il flag --remote-control) apre un tunnel per tutta la durata della sessione del terminale, mentre agy remote-control start avvia un daemon in background senza un terminale aperto. Su Linux, il daemon continua a funzionare dopo la disconnessione e si avvia dopo un riavvio; su Windows, per farlo è necessario installarlo come amministratore; su macOS e con un'installazione standard di Windows, riprende al successivo accesso. Il computer deve essere acceso e connesso a Internet. La funzionalità potrebbe non essere disponibile a causa delle regole dell'account o dell'organizzazione oppure delle condizioni del piano.
Se non hai ancora installato Antigravity, inizia con una panoramica di cos'è Google Antigravity e come installarlo. Questa guida è pensata per quando un agente sta già svolgendo un'attività lunga (refactoring, esecuzione di test, migrazione delle dipendenze) e devi allontanarti dalla scrivania mantenendo il controllo della sessione.
Cos'è Remote Control e perché ti serve
Remote Control è una funzionalità di Google Antigravity che ti consente di collegarti in modo sicuro alle sessioni desktop e CLI sui tuoi computer e di controllarle da qualsiasi browser web. Secondo la descrizione ufficiale, le attività più impegnative—per esempio il refactoring completo di un sottosistema, una lunga esecuzione di test o una migrazione complessa delle dipendenze—possono richiedere molto tempo. Remote Control ti consente di gestire una sessione mentre sei lontano dal computer, mantenendo locale l'intero ambiente di sviluppo.
La funzionalità è disponibile sia nell'app desktop 2.0 sia nella CLI, la versione di Antigravity per terminale (agy), ma l'attivazione e il comportamento differiscono nei due casi.
Abilitare Remote Control in Antigravity 2.0 desktop
Puoi abilitare Remote Control nelle impostazioni dell'app:
- Apri il pannello Settings con
Cmd + ,(oCtrl + ,su Linux e Windows), oppure fai clic sul pulsante Settings in fondo al pannello sinistro. - Vai alla sezione App.
- Imposta su On l'interruttore Enable Remote Control.
- (Facoltativo) Imposta un Nickname, ad esempio
workstation-primaryoserver-machine, così potrai riconoscere facilmente questo computer nell'elenco dei dispositivi connessi.
Collegarsi da un telefono o da un altro browser
Per aprire una sessione remota:
- Apri un browser su qualsiasi dispositivo e vai alla Dashboard di Antigravity Remote Control. Su un telefono puoi anche installare l'app web nella schermata Home per ricevere notifiche push quando l'agente termina un'attività o ti chiede una risposta.
- Accedi con lo stesso account Google che usi sul computer.
- Seleziona il computer desiderato nel selettore dei dispositivi.
- Una volta connesso, puoi vedere le conversazioni attive, avviare nuove attività per l'agente e visualizzare i piani di implementazione e gli artefatti.
Se il computer non compare nell'interfaccia web, le istruzioni ufficiali indicano di verificare tre cose: che l'interruttore Enable Remote Control sia attivo sul computer che esegue Antigravity; che il computer sia connesso a Internet e non sia entrato in modalità sospensione; e che l'app desktop e il browser usino lo stesso account Google.
Se la connessione di rete si interrompe temporaneamente sul dispositivo che stai usando per collegarti, l'interfaccia web proverà a riconnettersi automaticamente. Le attività in background dell'agente e i comandi avviati dal terminale continueranno a essere eseguiti sul computer con Antigravity senza interruzioni, purché resti connesso a Internet.
Le due modalità di Remote Control nella CLI di Antigravity
La CLI offre due modalità: una modalità interattiva legata a uno specifico processo del terminale e un daemon headless in background che viene eseguito senza un terminale aperto.
Modalità interattiva: /remote-control
Puoi abilitare Remote Control nella sessione interattiva agy corrente senza riavviare la CLI. Esegui questo comando nella riga di input:
/remote-control
Secondo la descrizione ufficiale, la CLI apre una connessione, un tunnel inverso, per la sessione corrente e stampa il nome host insieme a un link alla conversazione attiva, da aprire su un altro 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.
Apri il link in un browser su un laptop, tablet o telefono, accedi con lo stesso account Google che usi nella CLI e continua a lavorare nella sessione tramite l'interfaccia web di Antigravity.
Per disattivare il tunnel senza terminare la sessione del terminale locale:
/remote-control off
Puoi avviare la CLI con Remote Control già abilitato usando un flag all'avvio:
agy --remote-control
La modalità interattiva è legata al processo agy: quando esci dalla CLI (/exit, Ctrl+C, Ctrl+D) o chiudi la finestra del terminale, il tunnel Remote Control termina automaticamente e la sessione scompare dalla dashboard. Ogni processo CLI interattivo ha un ID sessione e un nome host distinti, quindi puoi eseguire contemporaneamente agy --remote-control in più schede del terminale o directory di lavoro.
Quando ti colleghi a una sessione CLI interattiva da un browser, i due lati si sincronizzano in tempo reale. Le richieste dal dispositivo remoto arrivano direttamente al terminale locale, mentre il ragionamento dell'agente, le chiamate agli strumenti e le modifiche al codice sono visibili nell'interfaccia remota. Se l'agente si ferma per chiedere conferma (y/n) o pone una domanda di approfondimento, puoi rispondere dal telefono o dal terminale locale. Le impostazioni fanno eccezione: non puoi modificarle dall'interfaccia web remota, ma solo dalla CLI stessa.
Daemon headless: agy remote-control start
La seconda modalità è un daemon persistente in background che si registra come servizio del sistema operativo. È disponibile quando il computer è acceso e connesso a Internet; il comportamento dopo la disconnessione e il riavvio dipende dalla piattaforma.
agy remote-control start
Il daemon si registra come servizio del sistema operativo (un servizio utente systemd su Linux, un LaunchAgent su macOS o un'attività pianificata su Windows) e si avvia subito, senza una finestra del terminale aperta.
Usa agy remote-control status per vedere il nome della voce. Seleziona quindi questo computer nella Dashboard di Antigravity Remote Control e continua a lavorare tramite l'interfaccia web di Antigravity.
Il daemon è controllato da tre comandi:
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
Il daemon usa le credenziali con cui hai effettuato l'accesso alla CLI. L'accesso alla CLI è separato da quello all'editor desktop Antigravity sullo stesso computer; nel browser, usa lo stesso account Google della CLI.
Puoi impostare il nome del computer del daemon headless con il flag --name all'avvio:
agy remote-control start --name "my-workstation"
Eseguendo di nuovo start --name con un nuovo valore, il nome del computer viene modificato.
Se non imposti un nome, al primo avvio il daemon ne genera uno facile da ricordare (ad esempio my-machine-distant-plume); agy remote-control status mostra il nome attuale. Puoi rinominarlo anche nel file delle impostazioni: apri ~/.gemini/config/config.json su Linux/macOS oppure %USERPROFILE%\.gemini\config\config.json su Windows, modifica il valore di cliRemoteControlHostname, salva il file ed esegui di nuovo agy remote-control start per riavviare il daemon. Il nuovo nome comparirà nella dashboard dopo il riavvio del servizio; le modifiche al file non hanno effetto mentre il daemon è in esecuzione.
Nel file ci sono due campi simili. cliRemoteControlHostname è il nome del daemon CLI usato in questo caso. remoteControlHostname è un campo separato per l'editor desktop Antigravity sullo stesso computer; in Antigravity 2.0 puoi modificarlo in Settings → App.
Comportamento del daemon dopo la disconnessione e il riavvio
Il comportamento dipende dal sistema operativo:
| Comportamento | Linux | macOS | Windows |
|---|---|---|---|
| Avvio | All'avvio; non è richiesto l'accesso | All'accesso | All'avvio (se installato da un amministratore); altrimenti all'accesso |
| Continua a funzionare dopo la disconnessione | Sì | No; riprende al successivo accesso | Sì, se configurato per avviarsi all'avvio |
| Si ripristina automaticamente dopo un errore | Sì | Sì | Sì, fino a tre tentativi di riavvio, poi al successivo avvio o quando viene eseguito di nuovo agy remote-control start |
Dettagli specifici per Windows
Per registrare il daemon per l'avvio automatico all'avvio del sistema è necessario eseguirlo come amministratore. Puoi usare PowerShell o il normale prompt dei comandi. Il comando start funziona anche da una finestra normale, ma dopo la disconnessione o il riavvio il daemon riprenderà solo al successivo accesso, non all'avvio. I comandi status e stop funzionano da una finestra normale senza privilegi elevati.
Quale modalità scegliere
| Criterio | Interattiva (/remote-control / agy --remote-control) | Daemon headless (agy remote-control start) |
|---|---|---|
| Ambito | Una sessione interattiva del terminale | L'intero computer (servizio del sistema operativo in background) |
| Ciclo di vita | Attiva mentre Remote Control è abilitato e la sessione del terminale è in esecuzione | Sopravvive alla disconnessione e ai riavvii su Linux e su Windows se installato da un amministratore; su macOS e con un'installazione standard di Windows riprende al successivo accesso |
| Nome della voce | Nuovo per ogni sessione (ad esempio host-swift-falcon) | Un nome permanente per il computer (--name o cliRemoteControlHostname) |
| Concorrenza | Più sessioni del terminale contemporaneamente su un computer | Un daemon per computer |
| Link diretto | La CLI stampa un link alla conversazione attiva | Accesso tramite il selettore dei dispositivi su antigravity.google.com |
| Ideale per | Allontanarsi da un'attività attiva nel terminale e continuarla da un telefono o browser | Accesso remoto persistente a una workstation o a un server mentre il computer è acceso e connesso a Internet, nel rispetto delle condizioni del sistema operativo |
La modalità interattiva è sufficiente per gestire un'attività in corso dal telefono. Se hai bisogno di accedere da remoto senza un terminale aperto, usa il daemon headless, nel rispetto delle condizioni del tuo sistema operativo.
Cosa fare in caso di problemi di connessione
Problemi e soluzioni indicati nella documentazione ufficiale:
| Cosa vedi | Perché | Cosa fare |
|---|---|---|
Remote control is not enabled for your account | Le regole dell'account o dell'organizzazione non hanno abilitato la funzionalità Remote Control | Contatta l'amministratore del tuo spazio di lavoro oppure verifica se il tuo piano supporta Remote Control |
| La voce scompare dalla dashboard (CLI) | /remote-control e agy --remote-control creano tunnel che si disconnettono automaticamente quando esci dalla sessione interattiva (/exit, Ctrl+C) o esegui /remote-control off | Se vuoi che il computer resti disponibile senza un terminale aperto, installa il daemon headless con agy remote-control start |
| Nella dashboard compaiono diverse voci CLI dello stesso computer | Ogni sessione CLI interattiva ha un proprio nome host; è normale quando sono aperti più terminali | Non è necessario intervenire; è il comportamento previsto |
| Il computer non compare nella dashboard (daemon) | Potrebbe esserci un problema di accesso alla CLI | Esegui agy remote-control status; se segnala un problema di accesso, esegui agy, accedi di nuovo e poi esegui ancora una volta agy remote-control start |
| La modifica del nome non ha avuto effetto | Il nome viene letto all'avvio del daemon | Esegui di nuovo agy remote-control start per riavviare il daemon |
| Su Windows, il daemon si avvia solo all'accesso, non all'avvio del sistema | Il comando start è stato eseguito senza privilegi di amministratore | Esegui di nuovo agy remote-control start da una finestra con privilegi elevati |
| La connessione continua a interrompersi e a ristabilirsi | Un vecchio daemon installato tramite lo script di installazione potrebbe essere ancora registrato e competere con quello nuovo per la connessione | Esegui di nuovo agy remote-control start; il vecchio servizio viene rimosso automaticamente |
| Nella dashboard compaiono due voci simili per un computer | Una voce è l'editor, l'altra è il daemon CLI; sono intenzionalmente separate | Rinomina la voce che vuoi distinguere |
| Il computer non compare nella dashboard web (desktop) | L'interruttore potrebbe essere disattivato, potrebbe mancare la connessione Internet, il computer potrebbe essere in sospensione oppure potrebbero essere in uso account Google diversi | Controlla l'interruttore Enable Remote Control, la connessione Internet del computer e che non sia in sospensione; verifica inoltre che l'account corrisponda su entrambi i dispositivi |
Per una diagnosi più approfondita, controlla i log del daemon: su Linux esegui journalctl --user -u antigravity-cli-daemon -n 50; su macOS controlla ~/Library/Logs/antigravity-cli-daemon.log; su Windows controlla il file cli-*.log più recente in %USERPROFILE%\.gemini\antigravity-cli\log.
Il daemon headless consente l'accesso senza un terminale aperto anche quando sei lontano, nel rispetto delle condizioni operative del computer e del sistema operativo. Se non ti serve più l'accesso persistente, arresta il daemon con agy remote-control stop.
È disponibile un articolo separato sul controllo remoto in Claude Code. Per controllare un altro agente tramite Telegram, consulta la configurazione di Hermes Agent in Telegram.
E adesso?
Se lavori nella CLI e vuoi allontanarti dall'attività corrente, inizia dalla modalità interattiva. Lascia aperto il terminale: se lo chiudi, il tunnel si disconnette e la voce della sessione scompare dalla dashboard. Per accedere al computer senza un terminale aperto, usa il daemon rispettando le limitazioni del tuo sistema operativo.
Fonti
Altri materiali sono disponibili su Ailoot.
Maggiori dettagli
Domande frequenti
Perché la sessione remota scompare quando chiudo il terminale?
Il Remote Control interattivo appartiene al processo agy in esecuzione: chiuderlo interrompe il tunnel. Per accedere senza terminale aperto, usa il daemon headless e controlla le sue condizioni di avvio nel sistema operativo.
Cosa controllo se il computer non compare nella dashboard?
Verifica che sia attivo e online, che Remote Control sia abilitato e che il browser usi lo stesso account Google del desktop o della CLI. Per una sessione daemon controlla agy remote-control status per problemi di accesso o servizio.