Beralih daripada Gemini CLI kepada Antigravity CLI: panduan

Pada 19 Mei 2026, Google mengumumkan bahawa mereka akan menamatkan Gemini CLI lama untuk semua pelan Free, Pro dan Ultra pada 18 Jun. Dua minggu selepas panduan ini diterbitkan, arahan gemini akan berhenti memproses permintaan. Beralih daripada Gemini CLI kepada Antigravity CLI dengan arahan agy ialah satu-satunya cara untuk terus menggunakan alat Google. agy dibina menggunakan Go dan bermula puluhan kali lebih pantas.

Jika anda mempunyai apa-apa yang sedang berjalan menggunakan Gemini CLI—skrip CI, tugas cron setiap malam, sambungan Gemini Code Assist untuk IDE—panduan ini menerangkan cara beralih dalam satu malam tanpa merosakkan apa-apa.

Apakah yang sebenarnya akan berhenti berfungsi pada 18 Jun 2026?#

Ini bukan “penutupan keseluruhan projek”, tetapi penamatan tiga pelan paling popular. Siapa yang terjejas:

Daripada Google Developers Blog rasmi:

Jika anda menggunakan pelan Free, seperti kebanyakan pembangun individu, dan berfikir “tetapi saya ada akaun berbayar”—semak dengan tepat cara kunci API anda dibilkan. AI Pro bukan pengebilan Cloud; ia langganan Google AI peribadi dan akan dinyahdayakan. Pengebilan Cloud dengan projek berbayar tidak akan dinyahdayakan.

Mengapa Google menamatkan Gemini CLI?#

gemini lama mengambil masa “ratusan milisaat” untuk bermula kerana Node.js perlu memanaskan enjin. agy baharu dibina sebagai satu binari Go statik dan bermula “dalam milisaat”. Bagi CI dan skrip yang memanggil CLI beratus kali dalam satu pelaksanaan, perbezaannya ketara.

Perkara yang Google katakan tentang kelajuan dan sebabnya:

Semua ciri utama Gemini CLI telah dipindahkan:

• Agent Skills — folder .gemini/skills/ kini berada di .agents/skills/.
• Hooks — peristiwa yang sama (PreToolUse, PostToolUse, dan sebagainya); sintaksnya hampir tidak berubah.
• Subagents — berfungsi seperti sebelumnya dan konfigurasinya dipindahkan secara automatik.
• Extensions — dinamakan semula sebagai pemalam Antigravity dan diimport dengan satu arahan.

Perkara yang tidak dipindahkan dengan lancar: pelayan MCP dan skrip lama yang mengakses .gemini/config.json secara langsung. Menurut perbincangan di GitHub, sesetengah pengguna melaporkan bahawa konfigurasi MCP rosak dan perlu ditulis semula secara manual. Terdapat bahagian berasingan tentang hal ini di bawah.

Google tidak menutup projek sumber terbuka Gemini CLI:

Ini bermakna anda boleh membuat fork dan terus menggunakannya dengan kunci Gemini API anda sendiri. Tetapi kini ia memerlukan persediaan berbayar melalui pengebilan Cloud; pilihan Code Assist percuma telah tamat.

Cara memasang Antigravity CLI: arahan untuk macOS, Linux dan Windows#

Sebelum bermula, buat semakan ringkas: pelan apakah yang anda gunakan? Jika anda mempunyai projek Cloud berbayar dan tiada tarikh akhir 18 Jun, pemindahan ini berguna tetapi tidak mendesak. Jika anda menggunakan Free/Pro/Ultra dan ada sesuatu yang berjalan melalui CLI, beralih sekarang ketika pelan masih aktif supaya anda boleh membandingkan tingkah laku pada tugas yang sama.

macOS dan Linux

Arahan satu baris menggunakan curl:

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

Skrip ini mengesan platform, memuat turun binari agy, menyemak jumlah semakannya dan meletakkannya di ~/.local/bin. Jika folder ini tiada dalam PATH, tambahkannya:

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

Semak sama ada binari boleh ditemui:

which agy
agy --version

Windows (PowerShell)

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

Binari akan dipasang di C:\Users\[your_name]\AppData\Local\agy\bin. Pemasang akan mengemas kini PATH secara automatik, tetapi buka tetingkap PowerShell baharu untuk memuat semula pemboleh ubah.

Windows (CMD)

Jika PowerShell disekat oleh dasar korporat anda:

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

Sahkan pemasangan

Selepas pemasangan pada mana-mana OS, jalankan:

agy doctor

Arahan ini menyemak versi binari, kewujudan konfigurasi, pengesahan dan akses rangkaian kepada antigravity.google. Jika ia tidak dapat menghubungi Google, masalahnya berkaitan wilayah atau proksi anda.

Pengesahan

Kali pertama anda menjalankan agy tanpa argumen, wizard persediaan akan dilancarkan:

1. Pilih tema antara muka.
2. Pilih kaedah pengesahan: Google OAuth (untuk akaun peribadi) atau kunci API.
3. Jika mahu, import konfigurasi daripada .gemini/ dengan serta-merta.

Jika anda memilih OAuth, pelayar akan dibuka dan mengubah hala anda ke accounts.google.com; anda perlu memberikan persetujuan untuk perkongsian data. Selepas itu, CLI boleh digunakan.

Cara memindahkan konfigurasi dan pemalam daripada .gemini ke .agents#

Langkah demi langkah:

1. agy plugin import gemini

   Jalankan arahan ini dari mana-mana folder. Ia akan memindahkan pemalam global daripada ~/.gemini/ ke ~/.agents/. Untuk pemalam workspace (di sebelah projek), jalankan arahan ini dari dalam folder projek.

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

   Pindahkan skills dengan menamakan semula folder secara manual. Format fail di dalamnya sama; markdown tidak perlu ditulis semula.

3. agy inspect

   Menunjukkan pemalam, skills, hooks dan subagents yang aktif. Bandingkan dengan senarai dalam Gemini CLI—tiada apa-apa yang sepatutnya tertinggal.

4. agy config --edit

   Membuka konfigurasi dalam editor lalai ($EDITOR). Jika ada sesuatu yang tidak diambil secara automatik, edit secara manual.

5. agy doctor

   Semakan akhir: binari, pengesahan, pemalam, rangkaian. Jika keempat-empatnya berwarna hijau, pemindahan konfigurasi selesai.

Saya akan membiarkan folder .gemini/ lama di tempatnya sebagai sandaran selama sebulan, sekiranya ada sesuatu yang tertinggal. Selepas menggunakan Antigravity selama seminggu dan mengesahkan semuanya ada, anda boleh memadamkannya.

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

Pemboleh ubah persekitaran yang manakah perlu diubah?#

Jadual penggantian lengkap:

Jika anda mempunyai GitHub Actions yang meneruskan rahsia, buka Settings -> Secrets -> Actions dan namakan semula kunci tersebut. Nilainya kekal sama (kunci Google API tidak berubah semasa pemindahan).

Semak semua tempat yang mungkin mengandungi GEMINI_:

# Find mentions throughout the project
grep -rn "GEMINI_" . --include="*.yml" --include="*.yaml" --include="*.sh" --include=".env*" 2>/dev/null

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

Selepas menggantikannya, mulakan semula terminal dan periksa kewujudannya tanpa mencetak rahsia. Jangan aktifkan penjejakan shell atau salin nilai kunci ke log. Kewujudan sahaja tidak membuktikan pengesahan; periksa agy doctor secara berasingan:

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        # should show “authorized”

Perkara yang paling kerap rosak semasa peralihan dan cara membaikinya#

Senarai semak masalah awal:

1. Pelayan MCP. Jika anda menggunakan mcp_servers dalam .gemini/config.json, pelayan itu mungkin tidak diambil selepas agy plugin import gemini. Semak dengan agy inspect—bahagian mcp akan dipaparkan. Jika bahagian itu kosong atau mengandungi ralat, tulis semula konfigurasi secara manual dengan agy config --edit. Formatnya diterangkan dalam dokumentasi rasmi Antigravity (cari bahagian MCP).

2. Hooks tersuai. Jika anda mempunyai skrip bash dalam .gemini/hooks/ yang membaca $GEMINI_API_KEY, skrip itu akan rosak. Cari lokasi sedemikian: bash

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

   Gantikan pemboleh ubah tersebut.

3. CI/CD. Dalam GitHub Actions atau GitLab CI, tukar langkah yang menggunakan arahan gemini kepada agy. Nama binari dalam pemasang mungkin berbeza, jadi cipta satu lapisan abstraksi menggunakan pemboleh ubah $CLI_CMD.

4. Sambungan IDE. Sambungan Gemini Code Assist untuk VS Code akan dinyahdayakan bersama CLI. Penggantinya ialah Antigravity IDE (fork VS Code yang berasingan) atau AGENTS.md dalam mana-mana editor AI yang lain.

5. Pemuatan @[file]. Dalam binaan awal Antigravity CLI, arahan @src/file.ts untuk memuatkan fail ke dalam konteks mempunyai pepijat. Kemas kini kepada versi terkini: agy update.

Jika sesuatu yang kritikal rosak dan tidak dapat dibaiki dalam masa sejam, penyelesaian sementara bagi pelan Free adalah dengan terus menggunakan Gemini CLI sehingga 18 Jun sambil menyediakan pemindahan pada cabang repositori yang berasingan. Had masa: 14 hari.

Patutkah anda terus menggunakan alat Google selepas 18 Jun?#

Antigravity 2.0 boleh dipertimbangkan sebagai pilihan sandaran apabila alat utama anda (Claude Code atau Codex) tidak sesuai. Untuk melihat dengan lebih terperinci kelebihan dan kekurangannya, rujuk panduan Google Antigravity 2.0.

Ringkasan ringkas tentang tindakan yang perlu diambil mengikut situasi anda:

Senarai semak pemindahan dalam 15 minit#

1. Pasang 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. Mulakan agy dan sahkan identiti

   Tanpa argumen: agy. Pilih OAuth atau kunci API.

3. Import pemalam daripada .gemini

   agy plugin import gemini—arahan ini memindahkan sambungan secara global. Jalankan sekali lagi dalam folder projek untuk pemalam workspace.

4. Pindahkan skills

   mv .gemini/skills/ .agents/skills/. Kandungan fail kekal seperti sedia ada.

5. Gantikan pemboleh ubah persekitaran

   Dalam ~/.zshrc/~/.bashrc dan fail .env: GEMINI_API_KEY → AV_API_KEY, GEMINI_PROJECT_ID → AV_PROJECT_ID, GEMINI_REGION → AV_REGION. Mulakan semula terminal.

6. Sahkan pemasangan

   agy doctor—keempat-empat item (binari, pengesahan, pemalam, rangkaian) sepatutnya berwarna hijau.

7. Jalankan tugas ujian

   agy "write a README for the project in the current folder"—semak sama ada hasilnya serupa dengan yang dihasilkan oleh Gemini CLI.

8. Kemas kini GitHub Actions / GitLab CI

   Tukar nama arahan dan rahsia daripada GEMINI_* kepada AV_*.

9. Kekalkan .gemini/ sebagai sandaran

   Anda boleh memadamkannya 1–2 minggu selepas mengesahkan semuanya berfungsi.

Akhir sekali: 18 Jun tidak bermaksud “semua projek anda akan terhenti”. Maksudnya saluran percuma akan dinyahdayakan. Akses API Cloud berbayar kekal tersedia, repositori Gemini CLI kekal tersedia dan fork masih boleh dibuat. Jika anda menggunakan pelan Free, anda perlu membuat keputusan sebelum 18 Jun; jika tidak, arahan gemini "something" yang seterusnya akan memulangkan ralat pengesahan.