Antigravity CLI (agy) di server

Sejak 18 Juni 2026, Gemini CLI tidak lagi melayani akun pribadi gratis, Google AI Pro, maupun Ultra. Pengumuman Google mengarahkan pengguna tersebut ke Antigravity CLI, agy. Di server, bagian yang perlu diperhatikan adalah login tanpa browser, memilih antara login Google dan kunci API, serta memahami cara agy menangani izin saat tidak ada orang di depan terminal. Berikut urutannya.

Pasang agy

Di Linux atau macOS, sebagai user biasa Anda (non-root):

curl -fsSL https://antigravity.google/cli/install.sh | bash
export PATH="$HOME/.local/bin:$PATH"   # if ~/.local/bin isn't on PATH yet
command -v agy

Halaman pemasangan resmi menyebutkan binary-nya masuk ke ~/.local/bin/agy dan mencantumkan macOS, Linux, dan Windows. Installer mengunduh build per platform, dengan build Linux untuk amd64 maupun arm64, jadi VPS ARM pun tidak masalah. Tambahkan baris PATH ke ~/.bashrc atau ~/.profile agar shell baru dan jendela tmux ikut mengenalinya.

Satu kebiasaan khusus server: agy memperbarui dirinya sendiri di latar belakang. Di laptop itu praktis. Di mesin yang Anda biarkan menyala terus, artinya versinya bisa berubah di tengah sesi yang panjang. Maude mengunci versi yang dipasangnya dan mematikan fitur ini dengan AGY_CLI_DISABLE_AUTO_UPDATE=1. Kalau Anda ingin kepastian yang sama, export variabel itu di shell atau unit yang menjalankan agy.

Alur login lewat SSH

Jalankan agy di sesi SSH dan pilih login Google. Di laptop, ia akan membuka browser. Lewat SSH, ia mendeteksi sesi jarak jauh dan menampilkan URL otorisasi sebagai gantinya. Lalu:

1. Salin URL-nya dan buka di ponsel atau laptop Anda.
2. Masuk dengan akun Google yang Anda pakai untuk Antigravity.
3. Salin kode yang diberikan halaman itu dan tempel kembali ke terminal.

Kredensial disimpan di keyring OS, yang di Linux berarti Secret Service. VPS polos tidak punya sesi desktop untuk membuka keyring. Sebuah issue GitHub untuk agy 1.0.0 melaporkan loop login di Linux headless karena persis hal itu, ditambah bug zona waktu pada cadangan berbasis file. Solusi sementara dari pelapornya adalah GEMINI_FORCE_FILE_STORAGE=true TZ=UTC agy …. Kami belum memastikan apakah versi terbaru masih membutuhkannya. Kalau agy meminta Anda login lagi setiap kali dijalankan, issue itu tempat pertama untuk dicek. Selain itu, pakai mode kunci API.

Untuk logout dan menghapus profil yang tersimpan, jalankan /logout di dalam agy.

Mode kunci API untuk headless

Untuk CI, mesin bersama, atau server mana pun yang tidak ingin Anda simpani sesi Google, jalankan agy dengan kunci API Gemini. Dokumentasi pemasangan memberi dua langkah. Pertama, atur penyedia model di ~/.gemini/antigravity-cli/settings.json. Gabungkan ke file itu jika sudah ada:

{
  "modelProvider": "gemini"
}

Lalu sediakan kuncinya untuk proses tersebut:

export GEMINI_API_KEY="…"   # e.g. in ~/.profile, or an EnvironmentFile for a systemd unit

Cara ini melewati login akun sepenuhnya. Pemakaian ditagih per token sesuai harga Gemini API, bukan dihitung dari paket Google AI. Jauhkan kuncinya dari riwayat shell dan dari repositori tempat agen bekerja.

Izin saat tidak ada yang mengawasi

Inilah perilaku di server yang paling sering mengejutkan orang. Dalam pengujian kami di agy 1.2.14, eksekusi headless (agy -p …, atau mode stream-json) tidak bisa berhenti dan bertanya sebelum sebuah tool berjalan. Perintah atau penulisan file yang butuh izin akan ditolak, dan hasil giliran itu mencantumkannya sebagai ditolak. Ada tiga cara untuk meloloskan pekerjaan:

• Aturan allow. agy membacanya dari permissions.allow di ~/.gemini/antigravity-cli/settings.json. Entrinya berbentuk "command(npm test)", "write_file(src/app.ts)", atau "command(*)". Aturan ini dibaca saat startup.
• Mode. --mode accept-edits otomatis menyetujui edit file, tapi perintah tetap ditolak. --mode plan membuat rencana tanpa bertindak.
• Tanpa pemeriksaan sama sekali. --dangerously-skip-permissions, untuk mesin sekali pakai. Baca menjalankan agen dengan izin penuh secara aman sebelum memakainya.

agy interaktif di terminal, dan Remote Control (di bawah), bisa berhenti dan bertanya. Jadi batasan ini khusus berlaku untuk penggunaan headless lewat skrip.

Membawa konfigurasi Gemini CLI Anda

Panduan migrasi membahas ini. Versi singkatnya untuk server yang sebelumnya sudah memakai Gemini CLI:

• Peluncuran pertama menawarkan migrasi. Jika agy menemukan konfigurasi Gemini CLI yang sudah ada, ia menampilkan daftar centang extension dan pengaturan global untuk dikonversi.
• Extension menjadi plugin. Jalankan agy plugin import gemini kapan saja untuk mengonversi extension Gemini menjadi plugin Antigravity.
• File konteks tetap berfungsi apa adanya. GEMINI.md (workspace dan ~/.gemini/GEMINI.md) serta AGENTS.md dibaca tanpa perubahan.
• Server MCP perlu sedikit diedit. Server global ada di ~/.gemini/config/mcp_config.json, server workspace di .agents/mcp_config.json. Ganti nama key lama url/httpUrl menjadi serverUrl.
• Skill pindah tempat. Skill workspace pindah dari .gemini/skills/ ke .agents/skills/, dan skill global ke ~/.gemini/antigravity-cli/skills/. Anda harus memindahkannya sendiri.

Google menyatakan fiturnya belum sepenuhnya setara, dan panduan migrasi mencatat bahwa beberapa tema kustom dan penyesuaian visual tidak ikut terbawa. Jika sebuah alur kerja bergantung pada extension tertentu, uji dulu setelah impor sebelum menghapus setup lama.

Daemon Remote Control vs Maude

Google menyediakan cara resmi untuk menjangkau agy dari perangkat lain. Menurut dokumentasi Remote Control, Anda bisa memulainya dengan tiga cara:

• /remote-control di dalam sesi yang sedang berjalan. Tunnel berakhir ketika sesi CLI itu keluar.
• agy --remote-control saat memulai sesi. Tunnel ini juga berakhir ketika sesinya keluar.
• Daemon headless: agy remote-control start --name my-vps, dengan agy remote-control status dan agy remote-control stop. Ia mendaftarkan layanan OS yang terus berjalan di latar belakang.

Anda mengendalikannya dari dashboard web di browser apa pun, masuk dengan akun Google yang sama. Dokumentasinya menyebutkan dashboard bisa dipasang ke layar utama ponsel untuk mendapat notifikasi push, dan permintaan izin bisa dijawab dari terminal maupun UI jarak jauh. Disebutkan juga bahwa feature flag akun atau organisasi bisa memblokirnya.

Jika Antigravity satu-satunya agen yang Anda pakai dan feature flag-nya aktif untuk akun Anda, daemon resmi adalah pilihan pertama yang paling jelas. Gratis, dan bisa bertanya sebelum bertindak.

Jalankan dari ponsel

Jika Anda ingin agy di server berdampingan dengan agen lain dan dikendalikan dari aplikasi native, Maude adalah salah satu pilihan. Tambahkan server, lalu aplikasi memasang agy pada versi yang sudah diuji dan membantu Anda login dari ponsel. Anda bisa memakai login Google dengan kode yang ditempel atau kunci API Gemini. Terus terang soal Antigravity di Maude: karena Maude menjalankan agy secara headless, ia tidak bisa berhenti dan bertanya sebelum sebuah tool berjalan. Maude menampilkan aksi yang ditolak, dan jika Anda menyetujuinya, Maude menambahkan aturan allow lalu mencoba ulang. Detailnya ada di halaman agen Antigravity. Perubahan Gemini CLI itu sendiri, dan opsi lain yang dipilih orang, dibahas di tulisan kami tentang berhentinya Gemini CLI.

Pertanyaan yang sering diajukan

Apa yang berubah

• 1 Oktober 2026 — Pertama kali diterbitkan. Detail pemasangan, autentikasi, migrasi, dan Remote Control dicek terhadap dokumentasi antigravity.google; perilaku izin headless dari pengujian kami sendiri di agy 1.2.14.