Gemini CLI-ден Antigravity CLI-ге көшу: нұсқаулық

2026 жылғы 19 мамырда Google Free, Pro және Ultra жоспарларының барлығында ескі Gemini CLI-ді 18 маусымда тоқтататынын жариялады. Бұл нұсқаулық жарияланғаннан кейін екі аптадан соң gemini командасы сұрауларды өңдеуді тоқтатады. Google құралдарын пайдалануды жалғастырудың жалғыз жолы — agy командасын қолданып, Gemini CLI-ден Antigravity CLI-ге көшу. agy Go тілінде жасалған және ондаған есе жылдам іске қосылады.

Егер Gemini CLI-де бірдеңе жұмыс істеп тұрса — CI скрипттері, түнгі cron тапсырмалары немесе Gemini Code Assist IDE кеңейтімі — бұл нұсқаулық ештеңені бұзбай, бір кеште қалай көшу керегін түсіндіреді.

2026 жылғы 18 маусымда нақты не жұмыс істемей қалады?#

Бұл «жобаны толық жабу» емес, ең танымал үш жоспарға қойылған шектеу. Кімдерге әсер етеді:

Google Developers Blog-тен:

Көптеген жеке әзірлеушілер сияқты Free жоспарын пайдалансаңыз және «бірақ менде ақылы аккаунт бар ғой» деп ойласаңыз, API кілтіңізге төлемнің қалай алынатынын нақты тексеріңіз. AI Pro Cloud төлемі емес; ол жеке Google AI жазылымы, сондықтан өшіріледі. Ақылы жобасы бар Cloud төлемі өшірілмейді.

Google Gemini CLI-ді неге мүлде тоқтатып жатыр?#

Ескі gemini командасы Node.js іске қосылуға дайындалуы керек болғандықтан «жүздеген миллисекундта» іске қосылатын. Жаңа agy — бір статикалық Go екілік файлы, ол «миллисекундтарда» іске қосылады. Бір іске қосу кезінде CLI-ді жүздеген рет шақыратын CI және скрипттер үшін бұл айырмашылық елеулі.

Жылдамдық пен себебі туралы Google не дейді:

Gemini CLI-дің барлық негізгі мүмкіндіктері көшірілді:

• Agent Skills — .gemini/skills/ қалтасы енді .agents/skills/ ішінде орналасады.
• Hooks — оқиғалар сол күйінде (PreToolUse, PostToolUse және т.б.); синтаксисі өте аз өзгерген.
• Subagents — бұрынғыдай жұмыс істейді, конфигурациясы автоматты түрде көшіріледі.
• Extensions — атауы Antigravity плагиндері болып өзгертілген және бір командамен импортталады.

Мінсіз көшпегендері: MCP серверлері және .gemini/config.json файлына тікелей қатынайтын ескі скрипттер. GitHub талқылауына сәйкес, кейбір пайдаланушылар MCP конфигурациялары бұзылып, оларды қолмен қайта жазуға тура келетінін хабарлаған. Бұл туралы төменде жеке бөлім бар.

Google Gemini CLI ашық бастапқы код жобасын жаппайды:

Демек, оны форктап, өз Gemini API кілтіңізбен пайдалануды жалғастыра аласыз. Бірақ енді бұл Cloud төлемі арқылы ақылы баптау; Code Assist-тің тегін нұсқасы аяқталады.

Antigravity CLI орнату: macOS, Linux және Windows командалары#

Бастамас бұрын, өз жоспарыңызды жылдам тексеріңіз. Ақылы Cloud жобаңыз болып, 18 маусымға дейінгі шектеу сізге қатысты болмаса, көшу пайдалы, бірақ шұғыл емес. Free/Pro/Ultra жоспарында болсаңыз және CLI-де бірдеңе жұмыс істеп тұрса, жоспарлар әлі белсенді кезде көшіңіз — сонда бір тапсырмадағы жұмысты салыстыра аласыз.

macOS және Linux

curl қолданатын бір жолдық команда:

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

Скрипт платформаны анықтайды, agy екілік файлын жүктейді, бақылау сомасын тексереді және оны ~/.local/bin ішіне орналастырады. Бұл қалта PATH ішінде болмаса, қосыңыз:

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

Екілік файл көрініп тұрғанын тексеріңіз:

which agy
agy --version

Windows (PowerShell)

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

Екілік файл C:\Users\[your_name]\AppData\Local\agy\bin ішіне орнатылады. Орнатқыш PATH айнымалысын автоматты түрде жаңартады, бірақ айнымалыларды қайта жүктеу үшін жаңа PowerShell терезесін ашыңыз.

Windows (CMD)

Корпоративтік саясатыңыз PowerShell-ді бұғаттаса:

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

Орнатуды тексеру

Кез келген операциялық жүйеге орнатқаннан кейін мына команданы орындаңыз:

agy doctor

Команда екілік файл нұсқасын, конфигурацияның бар-жоғын, аутентификацияны және antigravity.google желісіне қолжетімділікті тексереді. Google-ға қосыла алмаса, мәселе аймағыңызға немесе проксиіңізге байланысты.

Аутентификация

agy командасын алғаш рет аргументсіз іске қосқанда, ол бастапқы баптау шеберін ашады:

1. Интерфейс тақырыбын таңдаңыз.
2. Аутентификация әдісін таңдаңыз: Google OAuth (жеке аккаунттар үшін) немесе API кілті.
3. Қаласаңыз, .gemini/ ішіндегі конфигурацияны бірден импорттаңыз.

OAuth таңдасаңыз, браузер ашылып, сізді accounts.google.com сайтына бағыттайды; деректерді бөлісуге келісуіңіз керек. Одан кейін CLI жұмыс істейді.

Конфигурация мен плагиндерді .gemini ішінен .agents ішіне қалай көшіруге болады#

Қадам-қадаммен:

1. agy plugin import gemini

   Команданы кез келген қалтадан іске қосыңыз. Ол ғаламдық плагиндерді ~/.gemini/ ішінен ~/.agents/ ішіне көшіреді. Жұмыс кеңістігінің плагиндерін көшіру үшін команданы жоба қалтасының ішінде іске қосыңыз.

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

   Қалта атауын қолмен өзгерту арқылы skills-ті көшіріңіз. Ішіндегі файл пішімі өзгермейді; Markdown-ды қайта жазудың қажеті жоқ.

3. agy inspect

   Қай плагиндер, skills, hooks және subagents белсенді екенін көрсетеді. Мұны Gemini CLI-де болған тізіммен салыстырыңыз — ештеңе қалмауы керек.

4. agy config --edit

   Әдепкі редакторда ($EDITOR) конфигурацияны ашады. Бірдеңе автоматты түрде алынбаса, оны қолмен өңдеңіз.

5. agy doctor

   Соңғы тексеру: екілік файл, аутентификация, плагиндер, желі. Осы төртеуі де жасыл болса, конфигурацияны көшіру аяқталды.

Бірдеңе ұмыт қалған жағдайда, ескі .gemini/ қалтасын бір ай резервтік көшірме ретінде қалдырған жөн. Antigravity-ді бір апта пайдаланып, бәрі орнында екенін растағаннан кейін оны өшіруге болады.

Егер барлық AI құралдарына ортақ конфигурация ретінде AGENTS.md файлын пайдалансаңыз, оған тиіспеуіңізге болады. Antigravity CLI Claude Code немесе Codex пайдаланатын қалтадағы AGENTS.md файлын оқиды.

Қандай орта айнымалыларын өзгерту керек?#

Толық ауыстыру кестесі:

Құпия мәндерді беретін GitHub Actions болса, Settings -> Secrets -> Actions бөліміне кіріп, кілттердің атауын өзгертіңіз. Мәндердің өзі өзгеріссіз қалады (көшу кезінде Google API кілті өзгерген жоқ).

GEMINI_ кездесуі мүмкін барлық жерді тексеріңіз:

# Жоба бойынша кездесулерді іздеу
grep -rn "GEMINI_" . --include="*.yml" --include="*.yaml" --include="*.sh" --include=".env*" 2>/dev/null

# Dotfiles ішінен
grep -nE "GEMINI_" ~/.zshrc ~/.bashrc ~/.bash_profile ~/.config/fish/config.fish 2>/dev/null

Ауыстырғаннан кейін терминалды қайта іске қосып, құпияны шығармай бар екенін тексеріңіз. Shell tracing қоспаңыз және кілт мәнін журналдарға көшірмеңіз. Айнымалының болуы авторизацияны дәлелдемейді; agy doctor нәтижесін бөлек қараңыз:

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        # “authorized” деп көрсетуі керек

Көшу кезінде көбіне не бұзылады және оны қалай түзетуге болады#

Бастапқы мәселелерді тексеру тізімі:

1. MCP серверлері. .gemini/config.json ішінде mcp_servers қолдансаңыз, олар agy plugin import gemini командасынан кейін алынбауы мүмкін. agy inspect арқылы тексеріңіз — онда mcp бөлімі болады. Ол бос болса немесе қателер болса, agy config --edit арқылы қолмен қайта жазыңыз. Пішімі Antigravity-дің ресми құжаттамасында берілген (MCP бөлімін қараңыз).

2. Реттелетін hooks. .gemini/hooks/ ішінде $GEMINI_API_KEY оқитын bash скрипті болса, ол бұзылады. Ондай жерлерді табыңыз: bash

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

   Айнымалыларды ауыстырыңыз.

3. CI/CD. GitHub Actions немесе GitLab CI ішінде gemini командасын пайдаланатын қадамдарды agy командасына ауыстырыңыз. Орнатқыштағы екілік файлдың атауы өзгеше болуы мүмкін, сондықтан $CLI_CMD айнымалысын қолданып, абстракция жасаңыз.

4. IDE кеңейтімі. VS Code-қа арналған Gemini Code Assist кеңейтімі CLI-мен бірге өшіріледі. Оның орнына Antigravity IDE (VS Code-тың жеке форкы) немесе кез келген басқа AI редакторындағы AGENTS.md қолданылады.

5. @[file] арқылы жүктеу. Antigravity CLI-дің алғашқы құрастырылымдарында файлды контекстке жүктейтін @src/file.ts командасында қателер болды. Соңғы нұсқаға жаңартыңыз: agy update.

Маңызды нәрсе бұзылып, оны бір сағат ішінде түзете алмасаңыз, Free жоспары үшін уақытша шешім — көшуді репозиторийдің жеке тармағында баптап жатқанда Gemini CLI-ді 18 маусымға дейін пайдалана беру. Уақыт шегі: 14 күн.

18 маусымнан кейін Google құралдарын пайдалана берген жөн бе?#

Antigravity 2.0-ді негізгі құралыңыз (Claude Code немесе Codex) жарамайтын жағдайларда қосалқы нұсқа ретінде қарастыруға болады. Оның қай іске жарайтыны және қай тұсы нашар екені туралы толық мәліметті Google Antigravity 2.0 нұсқаулығынан қараңыз.

Жағдайыңызға қарай не істеу керегінің қысқаша шолуы:

15 минутта көшуге арналған тексеру тізімі#

1. Antigravity CLI орнату

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

2. agy іске қосу және аутентификациядан өту

   Аргументсіз: agy. OAuth немесе API кілтін таңдаңыз.

3. .gemini ішінен плагиндерді импорттау

   agy plugin import gemini — кеңейтімдерді ғаламдық деңгейде көшіреді. Жұмыс кеңістігінің плагиндерін көшіру үшін оны жоба қалтасының ішінде қайта іске қосыңыз.

4. Skills-ті көшіру

   mv .gemini/skills/ .agents/skills/. Файлдардың мазмұны өзгеріссіз қалады.

5. Орта айнымалыларын ауыстыру

   ~/.zshrc/~/.bashrc және .env файлдарында: GEMINI_API_KEY → AV_API_KEY, GEMINI_PROJECT_ID → AV_PROJECT_ID, GEMINI_REGION → AV_REGION. Терминалды қайта іске қосыңыз.

6. Орнатуды тексеру

   agy doctor — төрт тармақтың (екілік файл, аутентификация, плагиндер, желі) бәрі жасыл болуы керек.

7. Сынақ тапсырмасын орындау

   agy "осы қалтадағы жобаға README жаз" — нәтижені Gemini CLI жасаған нәтижемен салыстырыңыз.

8. GitHub Actions / GitLab CI жаңарту

   Команда атауын және құпия мәндердегі GEMINI_* атауларын AV_* атауларына өзгертіңіз.

9. .gemini/ қалтасын резервтік көшірме ретінде қалдыру

   Бәрі жұмыс істейтіні расталғаннан кейін 1–2 аптадан соң оны өшіруге болады.

Соңында айтарымыз: 18 маусым «барлық жобаңыз тоқтайды» дегенді білдірмейді. Тек тегін арна өшіріледі. Ақылы Cloud API қолжетімділігі сақталады, Gemini CLI репозиторийі қалады және форктар жасауға болады. Free жоспарын пайдалансаңыз, 18 маусымға дейін шешім қабылдауыңыз керек; әйтпесе, келесі gemini "something" командасы аутентификация қатесін қайтарады.