Google Antigravity Remote Control: Cara Mengendalikan Agen dari Ponsel
MarkdownCara mengaktifkan Remote Control di Google Antigravity pada desktop dan CLI: tombol pengalih, daemon agy remote-control, dan tindakan yang perlu dilakukan jika mengalami masalah koneksi.
Baca artikel lengkap
Dokumentasi Ailoot — materi referensi tentang penggunaan layanan.
Sorotan
Di Antigravity 2.0 desktop, Remote Control diaktifkan melalui tombol pengalih di Settings → App. Anda dapat terhubung ke sesi di antigravity.google.com menggunakan akun Google yang sama. Antigravity CLI memiliki dua mode: /remote-control (atau flag --remote-control) membuka terowongan selama sesi terminal berlangsung, sedangkan agy remote-control start menjalankan daemon latar belakang tanpa terminal yang terbuka. Di Linux, daemon tetap berjalan setelah Anda logout dan dimulai setelah reboot; di Windows, daemon harus dipasang oleh administrator; di macOS dan instalasi Windows standar, daemon berjalan kembali saat login berikutnya. Komputer harus menyala dan terhubung ke internet. Fitur ini mungkin tidak tersedia karena kebijakan akun atau organisasi, atau ketentuan paket.
Jika Anda belum memasang Antigravity, mulailah dengan ikhtisar tentang apa itu Google Antigravity dan cara memasangnya. Panduan ini ditujukan untuk situasi ketika agen sedang menangani tugas yang memakan waktu lama (refaktorisasi, menjalankan pengujian, memigrasikan dependensi) dan Anda perlu meninggalkan meja kerja tetapi tetap mengendalikan sesi.
Apa Itu Remote Control dan Mengapa Anda Membutuhkannya
Remote Control adalah fitur Google Antigravity yang memungkinkan Anda terhubung dengan aman ke sesi desktop dan CLI di mesin Anda, lalu mengendalikannya dari browser web mana pun. Menurut deskripsi resmi, tugas besar—misalnya, refaktorisasi seluruh subsistem, proses pengujian yang panjang, atau migrasi dependensi yang kompleks—dapat memakan waktu lama. Remote Control memungkinkan Anda mengelola sesi saat jauh dari komputer, sementara seluruh lingkungan pengembangan tetap berada di komputer Anda.
Fitur ini berfungsi di aplikasi desktop 2.0 maupun di CLI—versi Antigravity untuk terminal (agy)—tetapi cara mengaktifkan dan perilakunya berbeda di masing-masing versi.
Mengaktifkan Remote Control di Antigravity 2.0 Desktop
Anda dapat mengaktifkan Remote Control di pengaturan aplikasi:
- Buka panel Settings dengan
Cmd + ,(atauCtrl + ,di Linux dan Windows), atau klik tombol Settings di bagian bawah panel kiri. - Buka bagian App.
- Alihkan Enable Remote Control ke On.
- (Opsional) Atur Nickname, seperti
workstation-primaryatauserver-machine, agar Anda mudah mengenali mesin ini dalam daftar perangkat yang terhubung.
Menghubungkan dari Ponsel atau Browser Lain
Untuk membuka sesi jarak jauh:
- Buka browser di perangkat mana pun dan kunjungi Dasbor Antigravity Remote Control. Di ponsel, Anda juga dapat memasang aplikasi web di layar utama untuk menerima notifikasi push saat agen menyelesaikan tugas atau meminta tanggapan Anda.
- Masuk dengan akun Google yang sama dengan yang Anda gunakan di desktop.
- Pilih mesin yang diinginkan di pengalih perangkat.
- Setelah terhubung, Anda dapat melihat percakapan aktif, memulai tugas baru untuk agen, serta melihat rencana implementasi dan artefak.
Jika mesin tidak muncul di antarmuka web, petunjuk resmi menyarankan Anda memeriksa tiga hal: tombol Enable Remote Control sudah aktif di komputer yang menjalankan Antigravity; komputer tersebut terhubung ke internet dan tidak masuk mode tidur; serta aplikasi desktop dan browser menggunakan akun Google yang sama.
Jika koneksi jaringan pada perangkat yang Anda gunakan untuk terhubung terputus sementara, antarmuka web akan mencoba menyambungkan kembali secara otomatis. Tugas latar belakang agen dan perintah yang diluncurkan dari terminal akan terus berjalan di komputer dengan Antigravity tanpa gangguan, selama komputer tetap terhubung ke internet.
Dua Mode Remote Control di Antigravity CLI
CLI memiliki dua mode: mode interaktif yang terikat pada proses terminal tertentu dan daemon headless latar belakang yang berjalan tanpa terminal terbuka.
Mode Interaktif: /remote-control
Anda dapat mengaktifkan Remote Control di sesi agy interaktif saat ini tanpa memulai ulang CLI. Jalankan perintah ini di baris input:
/remote-control
Menurut deskripsi resmi, CLI membuka koneksi—terowongan balik—untuk sesi saat ini dan menampilkan nama host beserta tautan ke percakapan aktif untuk perangkat lain:
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.
Buka tautan ini di browser pada laptop, tablet, atau ponsel, masuk dengan akun Google yang sama dengan yang Anda gunakan di CLI, lalu lanjutkan bekerja dalam sesi melalui antarmuka web Antigravity.
Untuk menonaktifkan terowongan tanpa mengakhiri sesi terminal lokal:
/remote-control off
Anda dapat memulai CLI dengan Remote Control sudah aktif menggunakan flag saat menjalankan CLI:
agy --remote-control
Mode interaktif terikat pada proses agy: saat Anda keluar dari CLI (/exit, Ctrl+C, Ctrl+D) atau menutup jendela terminal, terowongan Remote Control akan berakhir secara otomatis dan entri sesi menghilang dari dasbor. Setiap proses CLI interaktif memiliki session ID dan nama host sendiri, sehingga Anda dapat menjalankan agy --remote-control secara bersamaan di beberapa tab terminal atau direktori kerja.
Saat terhubung ke sesi CLI interaktif dari browser, kedua sisi akan disinkronkan secara real-time. Permintaan dari perangkat jarak jauh langsung menuju terminal lokal, sementara penalaran agen, pemanggilan alat, dan perubahan kode terlihat di antarmuka jarak jauh. Jika agen berhenti sejenak untuk meminta konfirmasi (y/n) atau mengajukan pertanyaan lanjutan, Anda dapat menjawab dari ponsel atau terminal lokal. Pengaturan menjadi pengecualian: Anda tidak dapat mengubahnya dari antarmuka web jarak jauh, hanya dari CLI.
Daemon Headless: agy remote-control start
Mode kedua adalah daemon latar belakang persisten yang didaftarkan sebagai layanan OS. Layanan ini tersedia saat mesin menyala dan terhubung ke internet; perilakunya setelah logout dan reboot bergantung pada platform.
agy remote-control start
Daemon didaftarkan sebagai layanan OS (layanan systemd pengguna di Linux, LaunchAgent di macOS, atau Scheduled Task di Windows) dan langsung dimulai tanpa jendela terminal terbuka.
Gunakan agy remote-control status untuk melihat nama entri. Lalu pilih mesin ini di Dasbor Antigravity Remote Control dan lanjutkan bekerja melalui antarmuka web Antigravity.
Tiga perintah mengendalikan 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
Daemon menggunakan kredensial yang Anda gunakan untuk masuk ke CLI. Login ke CLI terpisah dari login ke editor desktop Antigravity di mesin yang sama; di browser, gunakan akun Google yang sama dengan yang digunakan di CLI.
Anda dapat mengatur nama mesin daemon headless menggunakan flag --name saat memulai:
agy remote-control start --name "my-workstation"
Menjalankan start --name lagi dengan nilai baru akan mengganti nama mesin.
Jika Anda tidak menetapkan nama, daemon akan membuat nama yang mudah diingat (seperti my-machine-distant-plume) saat pertama kali dijalankan; agy remote-control status menampilkan nama saat ini. Anda juga dapat mengganti namanya di file pengaturan: buka ~/.gemini/config/config.json di Linux/macOS atau %USERPROFILE%\.gemini\config\config.json di Windows, ubah nilai cliRemoteControlHostname, simpan file, lalu jalankan agy remote-control start lagi untuk memulai ulang daemon. Nama baru akan muncul di dasbor setelah layanan dimulai ulang; perubahan file tidak berlaku saat daemon sedang berjalan.
Ada dua field serupa di file tersebut. cliRemoteControlHostname adalah nama daemon CLI yang digunakan di sini. remoteControlHostname adalah field terpisah untuk editor desktop Antigravity di mesin yang sama; di Antigravity 2.0, Anda dapat mengubahnya di Settings → App.
Perilaku Daemon Setelah Logout dan Reboot
Perilakunya bergantung pada OS:
| Perilaku | Linux | macOS | Windows |
|---|---|---|---|
| Startup | Saat boot; tidak perlu login | Saat login | Saat boot (jika dipasang oleh administrator); jika tidak, saat login |
| Berjalan setelah logout | Ya | Tidak; berjalan kembali saat login berikutnya | Ya, jika dikonfigurasi untuk mulai saat boot |
| Pulih otomatis setelah kegagalan | Ya | Ya | Ya, hingga tiga kali percobaan memulai ulang, lalu saat boot berikutnya atau ketika agy remote-control start dijalankan lagi |
Detail Khusus Windows
Mendaftarkan daemon agar mulai otomatis saat sistem boot memerlukan hak administrator. Anda dapat menggunakan PowerShell atau command prompt biasa. Perintah start juga dapat dijalankan dari jendela biasa, tetapi setelah logout atau reboot, daemon hanya akan berjalan kembali saat login berikutnya, bukan saat boot. Perintah status dan stop dapat digunakan dari jendela biasa tanpa hak yang ditingkatkan.
Mode Mana yang Sebaiknya Dipilih
| Kriteria | Interaktif (/remote-control / agy --remote-control) | Daemon headless (agy remote-control start) |
|---|---|---|
| Cakupan | Satu sesi terminal interaktif | Seluruh mesin (layanan OS latar belakang) |
| Siklus hidup | Aktif selama Remote Control diaktifkan dan sesi terminal berjalan | Tetap berjalan setelah logout dan reboot di Linux serta Windows jika dipasang oleh administrator; di macOS dan instalasi Windows standar, berjalan kembali saat login berikutnya |
| Nama entri | Baru untuk setiap sesi (misalnya, host-swift-falcon) | Satu nama mesin permanen (--name atau cliRemoteControlHostname) |
| Penggunaan bersamaan | Beberapa sesi terminal sekaligus di satu mesin | Satu layanan daemon per mesin |
| Tautan langsung | CLI menampilkan tautan ke percakapan aktif | Akses melalui pengalih perangkat di antigravity.google.com |
| Cocok untuk | Meninggalkan tugas terminal yang sedang aktif dan melanjutkannya dari ponsel atau browser | Akses jarak jauh persisten ke workstation atau server selama mesin menyala dan terhubung ke internet, bergantung pada ketentuan OS |
Mode interaktif cukup untuk mengelola tugas saat ini dari ponsel. Jika Anda membutuhkan akses jarak jauh tanpa terminal terbuka, gunakan daemon headless, dengan memperhatikan ketentuan OS Anda.
Cara Mengatasi Masalah Koneksi
Masalah dan solusi dari dokumentasi resmi:
| Yang terlihat | Penyebab | Tindakan |
|---|---|---|
Remote control is not enabled for your account | Akun atau kebijakan organisasi Anda belum mengaktifkan fitur Remote Control | Hubungi administrator workspace Anda atau periksa apakah paket Anda mendukung Remote Control |
| Entri menghilang dari dasbor (CLI) | /remote-control dan agy --remote-control membuat terowongan yang terputus secara otomatis saat Anda keluar dari sesi interaktif (/exit, Ctrl+C) atau menjalankan /remote-control off | Jika mesin perlu tetap tersedia tanpa terminal terbuka, pasang daemon headless dengan agy remote-control start |
| Beberapa entri CLI dari mesin yang sama muncul di dasbor | Setiap sesi CLI interaktif memiliki nama host sendiri; ini normal saat beberapa terminal terbuka | Tidak perlu melakukan apa pun; ini memang perilaku yang diharapkan |
| Mesin tidak muncul di dasbor (daemon) | Mungkin ada masalah saat login ke CLI | Jalankan agy remote-control status; jika muncul masalah login, jalankan agy, login lagi, lalu jalankan agy remote-control start sekali lagi |
| Penggantian nama tidak diterapkan | Nama dibaca saat daemon dimulai | Jalankan agy remote-control start lagi untuk memulai ulang daemon |
| Di Windows, daemon hanya dimulai saat login, bukan saat boot | Perintah start dijalankan tanpa hak administrator | Jalankan agy remote-control start lagi dari jendela dengan hak yang ditingkatkan |
| Koneksi terus terputus dan tersambung kembali | Daemon lama yang dipasang melalui skrip instalasi mungkin masih terdaftar dan bersaing dengan daemon baru untuk koneksi | Jalankan agy remote-control start lagi; layanan lama akan dihapus secara otomatis |
| Dua entri serupa untuk satu mesin muncul di dasbor | Satu entri adalah editor, sedangkan yang lain adalah daemon CLI; keduanya memang dipisahkan | Ganti nama entri yang perlu Anda bedakan |
| Mesin tidak muncul di dasbor web (desktop) | Tombol pengalih mungkin tidak aktif, koneksi internet mungkin tidak tersedia, komputer mungkin sedang tidur, atau akun Google yang digunakan mungkin berbeda | Periksa tombol Enable Remote Control, koneksi internet komputer, pastikan komputer tidak sedang tidur, dan pastikan akun di kedua sisi sama |
Untuk diagnosis lebih lanjut, periksa log daemon: di Linux, jalankan journalctl --user -u antigravity-cli-daemon -n 50; di macOS, periksa ~/Library/Logs/antigravity-cli-daemon.log; di Windows, periksa file cli-*.log terbaru di %USERPROFILE%\.gemini\antigravity-cli\log.
Daemon headless menyediakan akses tanpa terminal terbuka, termasuk saat Anda sedang berada jauh, bergantung pada kondisi operasi komputer dan OS. Jika Anda tidak lagi membutuhkan akses persisten, hentikan daemon dengan agy remote-control stop.
Ada artikel terpisah tentang remote control di Claude Code. Untuk mengendalikan agen lain melalui Telegram, lihat cara menyiapkan Hermes Agent di Telegram.
Langkah Berikutnya
Jika Anda bekerja di CLI dan ingin meninggalkan tugas saat ini, mulailah dengan mode interaktif. Biarkan terminal tetap terbuka: jika Anda menutupnya, terowongan akan terputus dan entri sesi menghilang dari dasbor. Untuk mengakses mesin tanpa terminal terbuka, gunakan daemon dengan memperhatikan batasan OS Anda.
Sumber
Materi lainnya tersedia di Ailoot.
Rincian selengkapnya
Pertanyaan tentang Google Antigravity Remote Control: Cara Mengendalikan Agen dari Ponsel
Mengapa sesi remote hilang ketika terminal ditutup?
Remote Control interaktif milik proses agy yang berjalan, sehingga keluar dari proses menutup tunnel. Untuk akses tanpa terminal terbuka, gunakan daemon headless dan periksa syarat startup sistem operasinya.
Apa yang diperiksa jika mesin saya tidak muncul pada dasbor?
Pastikan mesin terjaga dan online, Remote Control aktif, dan browser memakai akun Google yang sama dengan desktop atau CLI. Untuk sesi daemon, periksa agy remote-control status guna menemukan masalah masuk atau layanan.