# Bermigrasi dari Gemini CLI ke Antigravity CLI: Panduan > Menginstal agy, memigrasikan konfigurasi, plugin, dan variabel lingkungan; pemeriksaan, kesalahan umum, dan pembatasan regional. Source: https://ailoot.ai/blog/id/gemini-cli-to-antigravity-cli-migration/ Canonical: https://ailoot.ai/blog/id/gemini-cli-to-antigravity-cli-migration/ Language: id Publisher: Ailoot (https://ailoot.ai/) Translation: guide-097 Revision: sha256-042cb8bf0296f5020db45712a247ff139dd41e72168a3542f2453ba0f6d88844 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.
Cara menghubungkan model dan menggunakan API dibahas dalam [dokumentasi Ailoot](https://ailoot.ai/docs/).
## Apa tepatnya yang akan berhenti berfungsi pada 18 Juni 2026?
Poin utama Pada 18 Juni 2026, Gemini CLI dan ekstensi Gemini Code Assist untuk VS Code akan berhenti memproses permintaan untuk tiga kategori pengguna: paket Free, Google AI Pro, dan Google AI Ultra. Instalasi baru Gemini Code Assist di GitHub tidak akan tersedia lagi; instalasi yang sudah ada akan dinonaktifkan “dalam beberapa minggu ke depan.” Akses API berbayar melalui Gemini Enterprise Agent Platform dan lisensi Code Assist Standard/Enterprise akan terus berfungsi tanpa perubahan.
Ini bukan “penutupan total proyek,” melainkan penghentian untuk tiga paket terpopuler. Siapa yang terdampak: | Paket | Yang ditawarkan | Yang akan terjadi pada 18 Juni 2026 | |----|----|----| | Paket Free | Akses ke Gemini Code Assist + CLI dengan batasan | Dinonaktifkan sepenuhnya | | Google AI Pro (sekitar \$19.99/bulan) | Batas CLI dan Code Assist yang lebih tinggi | Dinonaktifkan sepenuhnya | | Google AI Ultra (mulai dari \$100/bulan setelah I/O 2026) | Batas tertinggi | Dinonaktifkan sepenuhnya | | Gemini Code Assist untuk GitHub | Tinjauan PR otomatis Google di repositori Anda | Tidak ada instalasi baru; instalasi yang sudah ada akan dinonaktifkan dalam beberapa minggu ke depan | | Gemini Code Assist Standard / Enterprise (lisensi perusahaan) | Melalui akun Google Workspace perusahaan | Terus berfungsi tanpa perubahan | | API berbayar melalui Google Cloud (kunci Gemini API berbayar) | Permintaan ditagihkan ke proyek | Terus berfungsi tanpa perubahan | Dari Google Developers Blog resmi:

Pada 18 Juni 2026, Gemini CLI dan ekstensi IDE Gemini Code Assist akan berhenti memproses permintaan bagi pengguna Google AI Pro, Ultra, dan paket Free.

— Google Developers Blog, https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/
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?
Poin utama Gemini CLI adalah eksperimen TypeScript/Node.js terpisah di repositori GitHub Google. Google memutuskan untuk menyatukan semua alat agennya di bawah satu platform—Google Antigravity—dengan empat antarmuka: Antigravity 2.0 (aplikasi desktop), Antigravity CLI (terminal), Antigravity SDK (wrapper Python), dan Antigravity IDE (fork VS Code). Antigravity CLI telah ditulis ulang dari Node.js ke Go: aplikasi ini memulai dalam hitungan milidetik, bukan ratusan milidetik, dan menggunakan puluhan megabita memori, bukan ratusan.
`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:

Antigravity CLI dibuat dengan Go, berjalan lebih cepat, dan mendukung alur kerja latar belakang asinkron.

— Google Developers Blog, https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/
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:

Repositori akan tetap tersedia di GitHub di bawah lisensi Apache 2.0, dan kami akan terus mengerjakan proyek ini sebagai perangkat lunak sumber terbuka.

— Google Developers Blog (Diskusi #27274)
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
Poin utama Installer Google mendeteksi OS dan arsitektur secara otomatis, mengunduh biner, lalu menaruhnya di `~/.local/bin` (Linux/macOS) atau `C:\Users\[your_name]\AppData\Local\agy\bin` (Windows). Perintahnya berbeda untuk ketiga OS: di macOS dan Linux, satu baris perintah menggunakan `curl`; di Windows, gunakan PowerShell `irm` atau opsi CMD. Setelah instalasi, tambahkan path ke `PATH` jika installer belum melakukannya, buka terminal baru, lalu jalankan `agy doctor`—perintah ini memeriksa apakah biner ditemukan dan dapat terhubung ke Google.
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`: ```bash 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: ```bash echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc source ~/.zshrc ``` Periksa apakah biner tersedia: ```bash which agy agy --version ``` ### Windows (PowerShell) ```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: ```cmd 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: ```bash 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
Poin utama Antigravity CLI mencari konfigurasinya di `.agents/` di samping proyek dan di `~/.agents/` secara global—sama seperti Gemini CLI mencari di `.gemini/`. Migrasi dilakukan dengan satu perintah, `agy plugin import gemini`: perintah ini menelusuri `.gemini/extensions/`, memigrasikannya sebagai plugin Antigravity, dan memperbarui format konfigurasi. Pindahkan folder skills secara manual: `mv .gemini/skills/ .agents/skills/`. Setelah itu, `agy doctor` dan `agy inspect` akan menunjukkan apa yang terdeteksi, apa yang tidak, dan di mana ada duplikat.
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](https://ailoot.ai/blog/id/agents-md-guide-template/), Anda tidak perlu mengubahnya. Antigravity CLI membaca `AGENTS.md` dari folder yang sama dengan Claude Code atau Codex. ## Variabel lingkungan mana yang perlu diubah?
Poin utama Jika Anda memiliki skrip CI/CD, GitHub Actions, file `.env` lokal, atau dotfiles yang meneruskan `GEMINI_API_KEY` atau variabel lainnya, Anda perlu mengganti namanya. Awalan `GEMINI_` telah berubah menjadi `AV_` (untuk Antigravity). Antigravity CLI TIDAK akan membaca variabel lama.
Tabel penggantian lengkap: | Variabel lama (Gemini CLI) | Variabel baru (Antigravity CLI) | Nilai default | |----|----|----| | `GEMINI_API_KEY` | `AV_API_KEY` | \- | | `GEMINI_PROJECT_ID` | `AV_PROJECT_ID` | \- | | `GEMINI_REGION` | `AV_REGION` | `us-central1` | | `GEMINI_MODEL` | `AV_MODEL` | `gemini-3.5-flash` | | `GEMINI_API_BASE` | `AV_API_BASE` | Endpoint resmi Google | 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_`: ```bash # 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: ```bash 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
Poin utama Menurut diskusi GitHub, masalah yang paling umum adalah server MCP yang didefinisikan di `~/.gemini/config.json`, yang tidak terdeteksi secara otomatis—konfigurasi harus ditulis ulang dalam format Antigravity. Hook khusus yang menggunakan variabel lingkungan lama gagal tanpa pesan, sehingga pengujian gagal tanpa kesalahan yang jelas. Skrip yang mengakses `.gemini/` secara langsung (alih-alih melalui CLI) perlu dialihkan ke `.agents/`. Perintah `@[file]` untuk memuat file ke konteks mengalami bug saat Antigravity CLI pertama kali diluncurkan; masalah ini telah diperbaiki pada build terbaru, tetapi jika Anda menggunakan versi lama, perbarui.
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](https://antigravity.google) (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?
Poin utama Antigravity CLI memulai lebih cepat, berfungsi dengan Gemini 3.5 Flash, mendukung agen paralel dan tugas latar belakang asinkron melalui `agy --background`. Namun, ada dua potensi masalah: pembatasan akses regional dan ekosistem yang belum matang (lebih sedikit plugin dan server MCP dibandingkan Claude Code). Saya tidak akan bermigrasi ke Antigravity sebagai alat utama. Saya akan menggunakannya sebagai saluran cadangan untuk tugas latar belakang paralel, sambil mempertahankan pekerjaan pengembangan utama di Claude Code. Jika Anda menggunakan Gemini CLI dengan paket Free, 18 Juni adalah saat yang tepat untuk mempertimbangkan kembali seluruh perangkat kerja Anda.
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](https://ailoot.ai/blog/id/google-antigravity/). Ringkasan singkat tindakan yang perlu dilakukan sesuai situasi Anda: | Jika Anda... | Yang perlu dilakukan sebelum 18 Juni | |----|----| | Menggunakan Gemini CLI Free untuk eksperimen | Bermigrasi ke Antigravity CLI dengan akun yang dapat mengakses layanan ATAU beralih ke Claude/Codex—sesuai anggaran Anda | | Menggunakan Gemini Code Assist di IDE | Beralih ke Antigravity IDE atau kembali ke VS Code + Claude Code | | Menjalankan tugas cron malam melalui Gemini API dengan paket Free | Segera tulis ulang untuk API Cloud berbayar (yang tidak akan dinonaktifkan) ATAU pindahkan ke Claude API | | Bekerja melalui Cloud perusahaan (Standard/Enterprise) | Tidak perlu melakukan apa pun; penghentian ini tidak berdampak pada Anda | | Baru berpikir untuk mencoba Gemini CLI karena “gratis” | Jangan mulai; langsung gunakan [Claude Code](https://ailoot.ai/blog/id/claude-code/) atau [Codex](https://ailoot.ai/blog/id/codex-vs-claude-code-choice/) | ## Daftar periksa migrasi dalam 15 menit
Poin utama Jika Anda ingin cara tercepat tanpa membaca seluruh panduan, berikut urutan singkatnya. Di terminal baru tanpa skrip Gemini aktif, seluruh migrasi memerlukan 10–20 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.
### Sumber - [Google Developers Blog - Pembaruan penting: Transisi Gemini CLI ke Antigravity CLI](https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/) - [Antigravity CLI - Memulai](https://antigravity.google/docs/cli-getting-started) - [Antigravity CLI - Repositori GitHub](https://github.com/google-antigravity/antigravity-cli) - [Google Blog - Sorotan pengembang Google I/O 2026](https://blog.google/innovation-and-ai/technology/developers-tools/google-io-2026-developer-highlights/)
Lanjutkan bekerja dengan AI di [Ailoot](https://ailoot.ai/).
## Pertanyaan tentang Bermigrasi dari Gemini CLI ke Antigravity CLI: Panduan ### Bagaimana memverifikasi nama variabel kunci API yang baru tanpa mengeksposnya? Uji apakah `${AV_API_KEY:-}` tidak kosong dan tampilkan hanya pesan sudah diatur atau belum ada. Jangan echo nilai kunci atau menjalankan pemeriksaan dengan pelacakan shell aktif; gunakan `agy doctor` secara terpisah untuk memeriksa autentikasi. ### Apakah impor konfigurasi yang berhasil membuktikan seluruh migrasi selesai? Tidak. Bandingkan plugin, skill, hook, dan subagent aktif dengan konfigurasi lama, periksa pengaturan MCP, lalu jalankan tugas kecil. Pertahankan konfigurasi `.gemini/` lama sampai alur kerja dan hasil yang dimaksud terverifikasi. ## Ailoot · Perusahaan dan portofolio proyeknya Ailoot bertumpu pada pengalaman operasional yang teruji, basis pelanggan yang besar, layanan yang stabil, dan pemantauan KPI berkelanjutan. Perusahaan dan portofolio proyeknya: jutaan pelanggan; penjualan miliaran setiap bulan. Ailoot memanfaatkan pengalaman operasional ini untuk akses API ke fitur AI dalam produk pelanggan, agen, aplikasi, dan otomatisasi.