Bermigrasi dari Gemini CLI ke Antigravity CLI: Panduan

Pada 19 Mei 2026, Google mengumumkan bahwa mereka akan menghentikan Gemini CLI lama untuk semua paket Free, Pro, dan Ultra pada 18 Juni. Dua minggu setelah panduan ini diterbitkan, perintah gemini akan berhenti memproses permintaan. Bermigrasi dari Gemini CLI ke Antigravity CLI dengan perintah agy adalah satu-satunya cara untuk tetap menggunakan alat Google. agy dibuat dengan Go dan memulai puluhan kali lebih cepat.

Jika Anda menjalankan apa pun dengan Gemini CLI—skrip CI, tugas cron malam, ekstensi IDE Gemini Code Assist—panduan ini menjelaskan cara bermigrasi dalam satu malam tanpa merusak apa pun.

Apa tepatnya yang akan berhenti berfungsi pada 18 Juni 2026?#

Ini bukan “penutupan total proyek,” melainkan penghentian untuk tiga paket terpopuler. Siapa yang terdampak:

Dari Google Developers Blog resmi:

Jika Anda menggunakan paket Free, seperti kebanyakan pengembang perorangan, dan berpikir “tapi saya punya akun berbayar”—periksa secara tepat bagaimana kunci API Anda ditagihkan. AI Pro bukan penagihan Cloud; ini adalah langganan Google AI pribadi, dan akan dinonaktifkan. Penagihan Cloud dengan proyek berbayar tidak akan dinonaktifkan.

Mengapa Google menghentikan Gemini CLI?#

gemini lama memulai dalam “ratusan milidetik” karena Node.js perlu melakukan pemanasan. agy baru dibuat sebagai satu biner Go statis dan memulai dalam “milidetik.” Untuk CI dan skrip yang memanggil CLI ratusan kali dalam satu proses, perbedaannya signifikan.

Yang disampaikan Google tentang kecepatan dan alasannya:

Semua fitur utama Gemini CLI telah dipindahkan:

• Agent Skills — folder .gemini/skills/ kini berada di .agents/skills/.
• Hooks — peristiwanya sama (PreToolUse, PostToolUse, dll.); sintaksnya hampir tidak berubah.
• Subagents — berfungsi seperti sebelumnya, dan konfigurasinya dimigrasikan secara otomatis.
• Extensions — diganti nama menjadi plugin Antigravity dan diimpor dengan satu perintah.

Yang TIDAK dimigrasikan dengan mulus: server MCP dan skrip lama yang mengakses .gemini/config.json secara langsung. Menurut diskusi GitHub, beberapa pengguna melaporkan bahwa konfigurasi MCP rusak dan harus ditulis ulang secara manual. Ada bagian tersendiri tentang hal ini di bawah.

Google tidak menutup proyek sumber terbuka Gemini CLI:

Artinya, Anda dapat melakukan fork dan terus menggunakannya dengan kunci Gemini API Anda sendiri. Namun, sekarang ini merupakan penyiapan berbayar melalui penagihan Cloud; pengaturan Code Assist gratis sudah berakhir.

Cara menginstal Antigravity CLI: perintah untuk macOS, Linux, dan Windows#

Sebelum memulai, lakukan pemeriksaan singkat: paket apa yang Anda gunakan? Jika Anda memiliki proyek Cloud berbayar tanpa tenggat 18 Juni, migrasi berguna tetapi tidak mendesak. Jika Anda menggunakan Free/Pro/Ultra dan menjalankan sesuatu melalui CLI, beralihlah sekarang, selagi paketnya masih aktif, agar Anda dapat membandingkan perilakunya pada tugas yang sama.

macOS dan Linux

Satu baris perintah menggunakan curl:

curl -fsSL https://antigravity.google/cli/install.sh | bash

Skrip mendeteksi platform, mengunduh biner agy, memeriksa checksum-nya, lalu menaruhnya di ~/.local/bin. Jika folder ini tidak ada di PATH, tambahkan:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Periksa apakah biner tersedia:

which agy
agy --version

Windows (PowerShell)

irm https://antigravity.google/cli/install.ps1 | iex

Biner akan diinstal di C:\Users\[your_name]\AppData\Local\agy\bin. Installer akan memperbarui PATH secara otomatis, tetapi buka jendela PowerShell baru untuk memuat ulang variabel.

Windows (CMD)

Jika PowerShell diblokir oleh kebijakan perusahaan Anda:

curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd

Verifikasi instalasi

Setelah instalasi di OS apa pun, jalankan:

agy doctor

Perintah ini memeriksa versi biner, apakah konfigurasi tersedia, autentikasi, dan akses jaringan ke antigravity.google. Jika tidak dapat terhubung ke Google, masalahnya ada pada wilayah atau proksi Anda.

Autentikasi

Saat pertama kali Anda menjalankan agy tanpa argumen, wizard penyiapan akan terbuka:

1. Pilih tema antarmuka.
2. Pilih metode autentikasi: Google OAuth (untuk akun pribadi) atau kunci API.
3. Jika mau, impor konfigurasi dari .gemini/ saat itu juga.

Jika memilih OAuth, peramban akan terbuka dan mengarahkan Anda ke accounts.google.com; Anda perlu menyetujui berbagi data. Setelah itu, CLI siap digunakan.

Cara memigrasikan konfigurasi dan plugin dari .gemini ke .agents#

Langkah demi langkah:

1. agy plugin import gemini

   Jalankan perintah ini dari folder mana saja. Perintah ini akan memigrasikan plugin global dari ~/.gemini/ ke ~/.agents/. Untuk plugin ruang kerja (di samping proyek), jalankan perintah dari dalam folder proyek.

2. mv .gemini/skills/ .agents/skills/

   Pindahkan skills dengan mengganti nama folder secara manual. Format file di dalamnya sama; Anda tidak perlu menulis ulang Markdown.

3. agy inspect

   Menampilkan plugin, skills, hooks, dan subagents yang aktif. Bandingkan dengan daftar yang Anda gunakan di Gemini CLI—seharusnya tidak ada yang terlewat.

4. agy config --edit

   Membuka konfigurasi di editor default ($EDITOR). Jika ada yang tidak terdeteksi secara otomatis, edit secara manual.

5. agy doctor

   Pemeriksaan akhir: biner, autentikasi, plugin, jaringan. Jika keempatnya berstatus hijau, migrasi konfigurasi selesai.

Sebaiknya biarkan folder .gemini/ lama tetap ada sebagai cadangan selama sebulan, jika ada yang terlewat. Setelah menggunakan Antigravity selama seminggu dan memastikan semuanya tersedia, Anda dapat menghapusnya.

Jika Anda menggunakan AGENTS.md sebagai konfigurasi universal untuk semua alat AI, Anda tidak perlu mengubahnya. Antigravity CLI membaca AGENTS.md dari folder yang sama dengan Claude Code atau Codex.

Variabel lingkungan mana yang perlu diubah?#

Tabel penggantian lengkap:

Jika GitHub Actions Anda meneruskan secrets, buka Settings -> Secrets -> Actions dan ganti nama kuncinya. Nilainya tetap sama (kunci Google API tidak berubah selama migrasi).

Periksa semua tempat yang mungkin berisi GEMINI_:

# Temukan penyebutan di seluruh proyek
grep -rn "GEMINI_" . --include="*.yml" --include="*.yaml" --include="*.sh" --include=".env*" 2>/dev/null

# Di dotfiles
grep -nE "GEMINI_" ~/.zshrc ~/.bashrc ~/.bash_profile ~/.config/fish/config.fish 2>/dev/null

Setelah menggantinya, mulai ulang terminal dan periksa keberadaan kunci tanpa menampilkan rahasianya. Jangan aktifkan pelacakan shell atau menyalin nilai kunci ke log. Keberadaan saja tidak membuktikan otorisasi; periksa agy doctor secara terpisah:

if [ -n "${AV_API_KEY:-}" ]; then
    printf 'AV_API_KEY is set\n'
else
    printf 'AV_API_KEY is missing or empty\n'
fi
agy doctor        # seharusnya menampilkan “terautentikasi”

Apa yang paling sering rusak selama transisi dan cara memperbaikinya#

Daftar periksa masalah awal:

1. Server MCP. Jika Anda menggunakan mcp_servers di .gemini/config.json, server mungkin tidak terdeteksi setelah agy plugin import gemini. Periksa dengan agy inspect—akan ada bagian mcp. Jika kosong atau memiliki kesalahan, tulis ulang secara manual dengan agy config --edit. Formatnya dijelaskan dalam dokumentasi Antigravity resmi (cari bagian MCP).

2. Hook khusus. Jika Anda memiliki skrip bash di .gemini/hooks/ yang membaca $GEMINI_API_KEY, skrip itu akan rusak. Cari lokasi seperti ini: bash

   grep -rn "GEMINI_" .agents/hooks/ 2>/dev/null
   

   Ganti variabelnya.

3. CI/CD. Di GitHub Actions atau GitLab CI, ubah langkah yang menggunakan perintah gemini menjadi agy. Nama biner di installer mungkin berbeda, jadi buat abstraksi menggunakan variabel $CLI_CMD.

4. Ekstensi IDE. Ekstensi Gemini Code Assist untuk VS Code akan dinonaktifkan bersama CLI. Penggantinya adalah Antigravity IDE (fork VS Code terpisah) atau AGENTS.md di editor AI lainnya.

5. Pemuatan @[file]. Pada build awal Antigravity CLI, perintah @src/file.ts untuk memuat file ke konteks mengalami bug. Perbarui ke versi terbaru: agy update.

Jika ada hal penting yang rusak dan tidak dapat diperbaiki dalam satu jam, solusi sementara untuk paket Free adalah tetap menggunakan Gemini CLI sampai 18 Juni sambil menyiapkan migrasi di cabang repositori terpisah. Batas waktu: 14 hari.

Apakah Google layak digunakan setelah 18 Juni?#

Antigravity 2.0 dapat dipertimbangkan sebagai opsi cadangan saat alat utama Anda (Claude Code atau Codex) tidak sesuai. Untuk penjelasan terperinci tentang kelebihan dan kekurangannya, lihat panduan Google Antigravity 2.0.

Ringkasan singkat tindakan yang perlu dilakukan sesuai situasi Anda:

Daftar periksa migrasi dalam 15 menit#

1. Instal Antigravity CLI

   curl -fsSL https://antigravity.google/cli/install.sh | bash (macOS/Linux) atau irm https://antigravity.google/cli/install.ps1 | iex (Windows PowerShell).

2. Jalankan agy dan autentikasi

   Tanpa argumen: agy. Pilih OAuth atau kunci API.

3. Impor plugin dari .gemini

   agy plugin import gemini—perintah ini memigrasikan ekstensi secara global. Jalankan lagi di dalam folder proyek untuk plugin ruang kerja.

4. Pindahkan skills

   mv .gemini/skills/ .agents/skills/. Isi file tetap sama.

5. Ganti variabel lingkungan

   Di ~/.zshrc/~/.bashrc dan file .env: GEMINI_API_KEY → AV_API_KEY, GEMINI_PROJECT_ID → AV_PROJECT_ID, GEMINI_REGION → AV_REGION. Mulai ulang terminal.

6. Verifikasi instalasi

   agy doctor—keempat item (biner, autentikasi, plugin, jaringan) harus berstatus hijau.

7. Jalankan tugas uji

   agy "write a README for the project in the current folder"—periksa apakah hasilnya serupa dengan yang dihasilkan Gemini CLI.

8. Perbarui GitHub Actions / GitLab CI

   Ganti nama perintah dan secrets dari GEMINI_* menjadi AV_*.

9. Simpan .gemini/ sebagai cadangan

   Anda dapat menghapusnya 1–2 minggu setelah memastikan semuanya berfungsi.

Terakhir: 18 Juni tidak berarti “semua proyek Anda akan berhenti.” Artinya, saluran gratis akan dinonaktifkan. Akses API Cloud berbayar tetap tersedia, repositori Gemini CLI tetap tersedia, dan fork masih dimungkinkan. Jika Anda menggunakan paket Free, Anda perlu memutuskan sebelum 18 Juni; jika tidak, perintah gemini "something" berikutnya akan menghasilkan kesalahan autentorisasi.