Blog

Google Antigravity Remote Control: Cara Mengendalikan Agen dari Ponsel

Markdown

Cara 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:

  1. Buka panel Settings dengan Cmd + , (atau Ctrl + , di Linux dan Windows), atau klik tombol Settings di bagian bawah panel kiri.
  2. Buka bagian App.
  3. Alihkan Enable Remote Control ke On.
  4. (Opsional) Atur Nickname, seperti workstation-primary atau server-machine, agar Anda mudah mengenali mesin ini dalam daftar perangkat yang terhubung.

Menghubungkan dari Ponsel atau Browser Lain

Untuk membuka sesi jarak jauh:

  1. 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.
  2. Masuk dengan akun Google yang sama dengan yang Anda gunakan di desktop.
  3. Pilih mesin yang diinginkan di pengalih perangkat.
  4. 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.

Diagram: tombol Remote Control di laptop mengalihkan kendali ke ponsel saat masuk dengan akun yang sama
Cara kerja Remote Control desktop: aktifkan tombol di komputer, lalu masuk dari ponsel dengan akun Google yang sama.

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:

PerilakuLinuxmacOSWindows
StartupSaat boot; tidak perlu loginSaat loginSaat boot (jika dipasang oleh administrator); jika tidak, saat login
Berjalan setelah logoutYaTidak; berjalan kembali saat login berikutnyaYa, jika dikonfigurasi untuk mulai saat boot
Pulih otomatis setelah kegagalanYaYaYa, 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

KriteriaInteraktif (/remote-control / agy --remote-control)Daemon headless (agy remote-control start)
CakupanSatu sesi terminal interaktifSeluruh mesin (layanan OS latar belakang)
Siklus hidupAktif selama Remote Control diaktifkan dan sesi terminal berjalanTetap 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 entriBaru untuk setiap sesi (misalnya, host-swift-falcon)Satu nama mesin permanen (--name atau cliRemoteControlHostname)
Penggunaan bersamaanBeberapa sesi terminal sekaligus di satu mesinSatu layanan daemon per mesin
Tautan langsungCLI menampilkan tautan ke percakapan aktifAkses melalui pengalih perangkat di antigravity.google.com
Cocok untukMeninggalkan tugas terminal yang sedang aktif dan melanjutkannya dari ponsel atau browserAkses 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.

Diagram: terowongan sesi menghilang saat terminal ditutup; daemon latar belakang berjalan tanpa terminal yang terbuka
Perbedaan mode CLI: terowongan interaktif hanya berjalan selama terminal terbuka; daemon headless berjalan tanpa terminal yang terbuka (bergantung pada ketentuan OS pada tabel di atas).

Cara Mengatasi Masalah Koneksi

Masalah dan solusi dari dokumentasi resmi:

Yang terlihatPenyebabTindakan
Remote control is not enabled for your accountAkun atau kebijakan organisasi Anda belum mengaktifkan fitur Remote ControlHubungi 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 offJika mesin perlu tetap tersedia tanpa terminal terbuka, pasang daemon headless dengan agy remote-control start
Beberapa entri CLI dari mesin yang sama muncul di dasborSetiap sesi CLI interaktif memiliki nama host sendiri; ini normal saat beberapa terminal terbukaTidak perlu melakukan apa pun; ini memang perilaku yang diharapkan
Mesin tidak muncul di dasbor (daemon)Mungkin ada masalah saat login ke CLIJalankan agy remote-control status; jika muncul masalah login, jalankan agy, login lagi, lalu jalankan agy remote-control start sekali lagi
Penggantian nama tidak diterapkanNama dibaca saat daemon dimulaiJalankan agy remote-control start lagi untuk memulai ulang daemon
Di Windows, daemon hanya dimulai saat login, bukan saat bootPerintah start dijalankan tanpa hak administratorJalankan agy remote-control start lagi dari jendela dengan hak yang ditingkatkan
Koneksi terus terputus dan tersambung kembaliDaemon lama yang dipasang melalui skrip instalasi mungkin masih terdaftar dan bersaing dengan daemon baru untuk koneksiJalankan agy remote-control start lagi; layanan lama akan dihapus secara otomatis
Dua entri serupa untuk satu mesin muncul di dasborSatu entri adalah editor, sedangkan yang lain adalah daemon CLI; keduanya memang dipisahkanGanti 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 berbedaPeriksa 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.

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.

Semua artikel