기본 콘텐츠로 건너뛰기

Antigravity CLI Setup: Move From Gemini CLI Step by Step

Summary: Free and Google AI Pro/Ultra access to Gemini CLI ended on June 18, 2026, and Google now points those users to Antigravity CLI (the agy command). This guide walks through installing it, signing in, importing your old Gemini CLI extensions and skills, and fixing the setup errors people hit most often. Every step below was checked against Google's official Antigravity docs on October 31, 2026.

What changed, and who has to move

Google announced the switch on the Google Developers Blog on May 19, 2026. Starting June 18, 2026, Gemini CLI and the Gemini Code Assist IDE extensions stopped serving requests for people using them free of charge (Gemini Code Assist for individuals) and for Google AI Pro and Ultra subscribers. The Gemini CLI GitHub README now says the tool is meant for organizations with Gemini Code Assist Standard or Enterprise licenses, Code Assist for GitHub on Google Cloud, and legacy paid API or Vertex keys.

So the practical rule is simple:

  • You used Gemini CLI with a personal Google account (free, Pro or Ultra): move to Antigravity CLI.
  • Your company pays for Gemini Code Assist Standard/Enterprise: Gemini CLI keeps working for you, though you can also try Antigravity CLI with your Google Cloud projects.

Google says there is no 1:1 feature parity yet, but Antigravity CLI keeps Agent Skills, Hooks, Subagents and Extensions (now called plugins). It is written in Go and shares the same agent harness as the Antigravity desktop app, so improvements to the core agent show up in both.

Step 1: Install Antigravity CLI

The official Quickstart lists one installer command per operating system. At the time of writing, the download page shows Antigravity CLI version 1.4.10.

macOS, Linux or Googlebook

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

The binary lands in ~/.local/bin/agy.

Windows

In PowerShell:

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

In Command Prompt (CMD):

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

On Windows the default location is C:\Users\<username>\AppData\Local\agy\bin.

Check that it worked

Open a new terminal window and run:

agy --version

If you get agy: command not found, jump to the troubleshooting section below. It is almost always a PATH problem.

Step 2: First launch and sign-in

Go to a project folder and start the terminal UI:

cd your-project
agy

On the first launch, the CLI walks you through three quick choices:

  1. Color scheme: Dark, Solarized Dark, Solarized Light, or your terminal's default.
  2. Rendering mode: Alt-Screen (a full-screen buffer) or Inline (output stays in your normal terminal history). Choose Inline if you like scrolling back through earlier output.
  3. Workspace trust: confirm that you trust the folder before the agent starts indexing files.

Sign-in works in one of three ways, according to the Authenticate guide:

  • Local machine: the CLI first checks your operating system's keyring (Apple Keychain, Linux Secret Service over D-Bus, or Windows Credential Manager). If no saved session is found, it opens your default browser so you can sign in with your personal Google account.
  • Over SSH: the CLI notices it can't open a browser and prints an authorization URL. Open that URL on your local computer, sign in, copy the code the browser shows, and paste it back into the remote terminal.
  • Gemini API key (good for CI): set "modelProvider": "gemini" in ~/.gemini/antigravity-cli/settings.json, then export GEMINI_API_KEY="your-api-key". Setting only the environment variable does nothing. The CLI reads the key only from GEMINI_API_KEY, not from GOOGLE_API_KEY or a .env file.

Signing in once is shared across the Antigravity app, IDE extensions and CLI on the same machine. To sign out and clear the saved keyring profile, type /logout in the prompt box.

Step 3: Bring over your Gemini CLI setup

If your machine still has Gemini CLI settings, the first agy launch detects them and shows a checklist. You pick which extensions and global settings to convert, and your session tokens move into the OS keyring. If you skipped that screen, or you want to redo it, follow these steps.

3a. Convert extensions to plugins

agy plugin import gemini

This reads your old extension manifests and converts them. The sample output in the docs shows old custom commands being turned into skills, and MCP server definitions being moved into mcp_config.json. Read the report it prints. Lines marked "skipped" simply mean nothing of that type was found.

3b. Keep your GEMINI.md and AGENTS.md

You don't have to change anything here. Antigravity CLI still reads GEMINI.md and AGENTS.md in your project folder, plus your global ~/.gemini/GEMINI.md.

3c. Move workspace skills (manual step)

This is the step people miss. Project-level skills used to live in .gemini/skills/. Antigravity CLI looks in .agents/skills/ instead:

mkdir -p .agents
git mv .gemini/skills .agents/skills   # or plain mv if the folder isn't tracked

Global skills in ~/.gemini/skills/ still work, and ~/.gemini/antigravity-cli/skills/ is also accepted.

3d. Move MCP servers to their own file

Gemini CLI kept MCP servers inside ~/.gemini/settings.json. Antigravity CLI uses a separate file: ~/.gemini/config/mcp_config.json for global servers and .agents/mcp_config.json for one project. For remote SSE or WebSocket servers, rename the old url or httpUrl key to serverUrl:

{
  "mcpServers": {
    "my-remote-server": {
      "serverUrl": "https://example.com/sse"
    }
  }
}

Step 4: Run your first task safely

The Quickstart uses a small demo you can copy:

  1. Run mkdir agy-demo && cd agy-demo, then agy.
  2. Type a prompt such as Write a simple python script to fetch web page text and press Enter. The agent indexes the folder, makes a plan and proposes changes.
  3. Press Ctrl+R when prompted to open Artifact Review. Look over the diff, press Y to approve the new file, then Esc to go back.
  4. Ask it to Run the python script and show me the output, and press Y to allow the command.
  5. Exit with Ctrl+D or /exit.

Pay attention to the execution mode while you work. Press Shift+Tab to cycle through modes:

  • default asks before editing files and before running commands.
  • accept-edits approves file edits automatically but still asks before running commands.
  • auto (Preview) runs commands in a sandbox and still asks before anything irreversible. It needs v1.3.5+ on macOS/Linux or v1.4.4+ on Windows.
  • plan lays out the steps before writing any code.

Stay in default mode until you trust how the agent behaves in a given repo.

A few commands are worth learning on day one: /usage (credit use and quota), /config (settings), /permissions, /rewind or /undo, /resume, and ? for the full command list. To run commands from scripts, headless mode runs one prompt and exits: agy -p "your prompt", with --output-format json for output a program can parse. Authenticate once in an interactive session first. Otherwise a CI run exits with an "authentication required" error.

Plans and limits compared

Antigravity's pricing page and Plans doc describe limits in terms of quota rather than fixed prompt counts. The table below sticks to what those official pages say. Google AI Pro and Ultra prices aren't listed on the Antigravity pricing page, so check your Google One plan for those.

Plan Price shown Quota (per Plans doc) Extra usage
Individual (no subscription) $0/month A "meaningful quota" refreshed weekly, with a weekly rate limit; unlimited Tab completions AI credit overages described for Pro/Ultra only
Google AI Pro Not listed on Antigravity page High quota refreshed every five hours until a weekly limit is reached Purchased AI credits for overage
Google AI Ultra Not listed on Antigravity page Highest quota refreshed every five hours, highest weekly limit, third-party models Purchased AI credits for overage
Business (Google Cloud / Gemini Enterprise) API: consumption-based; Standard/Plus from $30 per seat per month; pay-as-you-go with $0 seat fee Under Google Cloud terms, with spend caps and admin controls Consumption pricing

The Plans doc also says bring-your-own-key for extra rate limits isn't supported. The Gemini API key option in Step 2 sends requests straight to the Gemini API, which bills separately, so it doesn't add to your plan quota.

Editor's note

Good fit: developers who used Gemini CLI on a personal account and want to stay in the terminal, and anyone who wants background subagents without opening a full IDE.

Not ideal: teams that depend on custom Gemini CLI themes or experimental visual overlays (the migration doc warns these may not carry over), or anyone who needs fixed, predictable prompt counts. Quota depends on how much work each task takes.

Common errors and fixes (from the official troubleshooting page):

  • agy: command not found: add export PATH="$HOME/.local/bin:$PATH" to ~/.bashrc or ~/.zshrc, then reload it. On Windows, add the install folder to your user Path and restart the terminal.
  • secret keyring is locked on Linux over SSH: make sure GNOME Keyring or KWallet is unlocked. In headless sessions, start a D-Bus session with export $(dbus-launch).
  • update.lock warning or the CLI hangs while updating: delete ~/.gemini/antigravity-cli/updater/update.lock, or set AGY_CLI_DISABLE_AUTO_UPDATE=true.
  • API key mode exits at startup: modelProvider is set to gemini but GEMINI_API_KEY isn't exported in that shell.
  • Skills don't show up as slash commands: they're still in .gemini/skills/. Move them to .agents/skills/.

FAQ

Can I still use Gemini CLI for free?

No. Since June 18, 2026, Gemini CLI no longer serves free individual use or Google AI Pro/Ultra accounts. It stays available for Gemini Code Assist Standard/Enterprise organizations and paid API keys. Free personal use has moved to Antigravity CLI's $0 Individual plan.

Do I need to rewrite my GEMINI.md files?

No. Antigravity CLI reads the same project GEMINI.md and AGENTS.md files and your global ~/.gemini/GEMINI.md. What you do need to move are workspace skills (to .agents/skills/) and MCP server entries (to mcp_config.json).

How do I see how much quota I have left?

Run /usage inside the CLI. If you're on a paid plan with AI credits, the right side of the status line shows your remaining credit count. The useG1Credits setting (or "Use G1 Credits" in /config) controls whether credits are spent once your plan quota runs out.

Related on this blog: Cline Tutorial: Plan, Act and Roll Back Safely in VS Code · Aider Not Working? Fixes for Edit, Token and API Key Errors · Windsurf Is Now Devin Desktop: Fixes for Common Problems

If you only do one thing today, run agy plugin import gemini and move your .gemini/skills folder. That covers most of the migration.

Image credits: Google Developers Blog (official announcement cover) and the author's own screenshots of public Google Antigravity pages (Quickstart, Gemini CLI migration guide, pricing). See the official screenshots at the end of this post.


Last verified: 2026-10-31 · By zeromy

Sources:
Google Developers Blog: Transitioning Gemini CLI to Antigravity CLI
Gemini CLI GitHub README
Antigravity Quickstart
Antigravity Authenticate guide
Migrating from Gemini CLI
CLI troubleshooting
Execution modes
Plans · Pricing · Download

Uploaded Image Uploaded Image Uploaded Image Uploaded Image

댓글

이 블로그의 인기 게시물

브루(Vrew) 요금제 정리: 무료 200크레딧으로 어디까지 쓸 수 있나

요약: 영상 자막 편집기 브루(Vrew)는 2026년 4월 22일부터 기능별 사용량 대신 '통합 크레딧' 하나로 요금을 매겨요. 무료 플랜은 매달 200크레딧이 들어오는데, 음성 분석(자동 자막)만 쓰면 최대 200분 분량이라 짧은 영상 몇 편은 충분하지만, 영상 초반의 Vrew 마크를 지우려면 유료 플랜이 필요해요. 이 글은 브루 공식 가격 페이지와 고객센터 공지를 2026년 10월 23일에 다시 확인해, 크레딧 계산법과 플랜 고르는 기준을 정리했어요. 목차 브루 요금 구조: 통합 크레딧이란 1크레딧으로 할 수 있는 일 무료 플랜으로 되는 것과 안 되는 것 유료 플랜 4종 비교표 월 구독·연 구독·기간 이용권, 무엇이 이득일까 상황별 추천: 학생·직장인·유튜버 크레딧이 모자랄 때: 사용 기록 지우개 업그레이드·환불 전에 알아둘 규칙 운영자 메모, 자주 묻는 질문 1. 브루 요금 구조: 통합 크레딧이란 예전 브루는 플랜마다 음성 분석 몇 분, AI 목소리 몇 자, 번역 몇 자처럼 기능별 한도를 따로 줬어요. 그런데 보이저엑스(브루 운영사)가 실제 이용 데이터를 보니 한두 가지 기능만 집중해서 쓰는 사람이 훨씬 많았다고 해요. 그래서 2026년 4월 22일 업데이트부터는 플랜마다 정해진 크레딧을 받고, 어떤 기능에 쓸지는 내가 정하는 방식으로 바뀌었어요. 플랜별 매달 지급량은 Free 200 · Light 2,000 · Standard 10,000 · Business 12,000크레딧 이에요. 공식 공지에 따르면 무료 사용자는 매달 1일에, 유료 사용자는 매월 결제일에 충전되고, 남은 크레딧은 다음 달로 넘어가지 않아요. 바뀐 뒤 무엇이 좋아졌나 공지에 나온 예시가 이해하기 쉬워요. Standard 플랜에서 AI 목소리만 쓰면 예전에는 최대 50만 자였지만, 지금은 1만 크레딧을 모두 AI 목소리에 몰아 쓸 수 있어 최대 100만 자가 돼요. 반대로 여러 기능을 골고루 쓰는 사람은 크레딧이 기능끼리 ...

에이닷 전화 vs 익시오: 통화 녹음·AI 요약, 내 통신사·폰에 맞는 앱 고르기

요약: 통화 녹음과 AI 요약을 쓰고 싶다면 먼저 내 통신사와 휴대폰 종류부터 확인해야 해요. LG유플러스 고객은 무료 앱 익시오, SKT 고객은 에이닷 전화가 가장 기능이 많고, 다른 통신사의 아이폰 사용자는 iOS에 들어 있는 기본 통화 녹음·전사 기능이 현실적인 선택이에요. 이 글은 2026-10-30에 SKT·LG유플러스·Apple 공식 페이지와 도움말을 직접 확인해 세 가지를 비교했어요. 왜 '앱 기능'보다 '내 조건'을 먼저 봐야 할까요 통화 요약 앱 비교 글을 보면 기능 목록부터 나열하는 경우가 많아요. 그런데 실제로 써 보려는 사람에게 가장 먼저 걸리는 건 기능이 아니라 이용 조건 이에요. 익시오는 LG유플러스 고객 전용이고, 에이닷 전화는 누구나 설치할 수 있지만 통역콜·baro 같은 기능은 SKT 고객에게만 열려 있어요. 아이폰은 운영체제 구조상 앱이 통화를 마음대로 녹음하기 어려워서, 통신사 앱이 안 되면 iOS 기본 기능에 기대야 해요. 그래서 이 글은 "어떤 앱이 제일 좋은가"보다 "내 통신사·내 폰에서 무엇을 쓸 수 있나" 순서로 정리했어요. 기능 차이는 그다음이에요. 한눈에 비교: 에이닷 전화 vs 익시오 vs 아이폰 기본 통화 녹음 구분 에이닷 전화 (SKT) 익시오 ixi-O (LG유플러스) 아이폰 기본 통화 녹음 (Apple) 누가 쓸 수 있나 통신사 구분 없이 앱 설치 가능. 단, 통역콜·baro·그룹통화 발신 등은 SKT 고객 전용 U+ 모바일 고객. 타 통신사, 만 14세 미만, 선불요금제 고객은 제한 (공식 사이트 FAQ상 알뜰폰 중 KB리브엠은 예외) 지원 국가·언어의 iPhone 사용자. 1명과 통화할 때만 녹음 가능 지원 OS·기기 Android 10 이상, iOS 16 이상 iOS 17 이상 iPhone 12 이상 / Android...

타입캐스트 vs 클로바더빙: 수익 나는 채널에 쓸 때 무료·유료 조건 비교

요약 타입캐스트와 클로바더빙은 둘 다 글만 입력하면 한국어 AI 목소리를 만들어 주는 서비스지만, 무료로 쓸 수 있는 범위가 꽤 다릅니다. 클로바더빙 무료는 매달 15,000자까지 쓸 수 있는 대신 수익이 생기는 채널에는 쓸 수 없고, 타입캐스트 무료는 처음에 주는 약 5분 분량의 다운로드로 끝나는 체험판에 가깝습니다. 광고 수익이 붙은 유튜브나 쇼핑몰 영상에 넣을 목소리라면 처음부터 유료 플랜 조건을 보고 고르는 편이 안전합니다. 왜 이 두 서비스를 같이 비교하나 쇼츠 내레이션, 수업 자료 더빙, 상품 소개 영상처럼 "내 목소리 대신 AI 목소리"가 필요할 때 한국 사용자들이 가장 많이 찾는 곳이 네오사피엔스의 타입캐스트 와 네이버의 클로바더빙 입니다. 기능 소개만 보면 비슷해 보이지만, 실제로 문제가 되는 건 음질보다 "이 목소리를 내 채널에 써도 되나" 입니다. 그래서 이 글은 기능 나열보다 무료 사용 범위, 출처 표기 의무, 유료 플랜 가격과 다운로드 한도를 중심으로 정리했습니다. 모든 수치는 2026년 10월 25일에 두 서비스의 공식 요금 페이지와 고객센터 도움말에서 직접 다시 확인한 내용입니다. 한눈에 보는 비교표 항목 타입캐스트 무료 타입캐스트 베이직 클로바더빙 Free 클로바더빙 Standard 월 요금 0원 9,900원 (연간 결제 시 10% 할인) 0원 19,900원 (네이버 클라우드 플랫폼에서 결제) 무료·포함 사용량 음성 생성·재생 무제한, 다운로드는 최초 3,000크레딧(약 5분) 1회 지급 월 30,000크레딧(약 60분) 월 15,000자, 다운로드 월 20회, 프로젝트 누적 5개 (매월 1일 갱신) 월 30,000자, 다운로드 월 40회, 프로젝트 누적 20개 쓸 수 있...