6월 18일이면 gemini 명령어가 멈춥니다 — Antigravity CLI 마이그레이션 실전 가이드

CI/CD 파이프라인에 gemini 명령어 박아두신 분들, 지금 당장 확인하셔야 합니다.

---

한줄요약: 2026년 6월 18일부터 Gemini CLI는 개인/Pro/Ultra 사용자에게 응답을 완전히 중단하고, 후속 도구인 Antigravity CLI(agy)로 전환이 강제됩니다.

---

왜 갑자기 종료되나요?

구글은 Google I/O 2026(5월 19일)에서 Antigravity 2.0 플랫폼을 발표하면서, 기존 Gemini CLI를 함께 종료한다고 밝혔습니다. 단순 리브랜딩이 아니라 아키텍처 자체가 바뀌었습니다.

기존 Gemini CLI는 Node.js 기반의 단일 에이전트 구조였고, Antigravity CLI는 Go로 재작성한 멀티 에이전트 플랫폼입니다. 더 중요한 것은 Antigravity 2.0 데스크탑 앱, SDK, Managed Agents API가 모두 같은 에이전트 하네스를 공유한다는 점입니다. 구글 입장에서는 하나의 스택으로 통합하겠다는 선언이죠.

참고로 Gemini CLI는 GitHub 스타 10만 개를 넘은 Apache 2.0 오픈소스였습니다. 커뮤니티 PR 6,000개 이상을 받아온 프로젝트를 닫으면서 개발자들 사이에서 반응이 뜨겁기도 했습니다.

---

내 계정은 영향받나요?

✅ 영향받음 → 6월 18일 전에 마이그레이션 필수
  - Google AI Pro 구독자
  - Google AI Ultra 구독자
  - 무료 Gemini Code Assist (개인) 사용자
  - Gemini Code Assist for GitHub 조직 (신규 설치 차단)

❌ 영향 없음 → 지금 당장은 그대로 사용 가능
  - Gemini Code Assist Standard / Enterprise 라이선스 보유 조직
  - Gemini Enterprise Agent Platform 유료 API 키 사용자

Enterprise 사용자라면 Gemini CLI 접근이 계속 유지되고, 최신 Gemini 모델 업데이트도 받을 수 있습니다.

---

뭐가 실제로 멈추나요?

6월 18일 이후 gemini 바이너리를 직접 호출하는 모든 작업이 응답을 반환하지 않습니다. 특히 아래 케이스들을 먼저 점검하세요.

- CI/CD 파이프라인에 gemini 셸 스텝이 있는 경우
- 야간 분석/생성 자동화 크론 잡
- gemini -p "..." 형태의 셸 스크립트
- Gemini CLI를 쉘 아웃으로 호출하는 커스텀 툴링

중요: 단순히 느려지거나 오류 메시지가 나오는 게 아닙니다. 파이프라인 자체가 종료 코드 실패로 죽습니다.

---

Antigravity CLI 마이그레이션 — 4단계

Step 1. 설치

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

# Windows (PowerShell)
irm https://antigravity.google/cli/install.ps1 | iex

# 설치 확인
agy --version

명령어가 gemini에서 agy로 바뀝니다. 스크립트 전체를 검색해서 일괄 치환하세요.

Step 2. 인증

agy
# 로컬 환경: 브라우저가 열리며 Google OAuth 진행
# CI/CD 환경: 서비스 계정 토큰 사용
agy --auth-token $AGY_TOKEN
# 또는 환경변수로: AGY_TOKEN=your_token

Gemini CLI의 서비스 계정 플로우와 동일한 스코프를 사용합니다.

Step 3. 플러그인 마이그레이션

agy plugin import gemini

익스텐션, 슬래시 명령어, MCP 항목 대부분이 이 한 줄로 자동 이전됩니다. 머신당 한 번만 실행하면 됩니다.

Step 4. 설정 파일 마이그레이션 ⚠️ 가장 중요

MCP 설정 — 조용한 실패 함정

가장 많은 파이프라인이 여기서 조용히 깨집니다. Gemini CLI는 MCP 설정을 settings.json에 인라인으로 저장했는데, Antigravity CLI는 별도 파일에 필드명도 바뀌었습니다.

// ❌ 기존: .gemini/settings.json
{
  "mcpServers": {
    "my-server": {
      "url": "https://my-mcp-server.example.com"
    }
  }
}

// ✅ 신규: .agents/mcp_config.json
{
  "mcpServers": {
    "my-server": {
      "serverUrl": "https://my-mcp-server.example.com"
    }
  }
}

url → serverUrl 하나만 바꾸면 되는데, 이걸 놓치면 Antigravity CLI가 설정 파일을 에러 없이 로드하면서 MCP 서버에는 연결하지 않습니다. 에이전트는 툴 없이 조용히 실행되고, 잘못된 결과를 냅니다.

Skills 마이그레이션

# 각 프로젝트 루트에서 실행
mkdir -p .agents
git mv .gemini/skills .agents/skills

프로젝트마다 수동으로 해줘야 합니다.

---

Gemini CLI vs Antigravity CLI 핵심 차이

항목               Gemini CLI          Antigravity CLI
───────────────────────────────────────────────────────
언어               Node.js             Go (재작성)
실행 방식          단일 에이전트       멀티 에이전트 (비동기 병렬)
데스크탑 동기화    별개 구현체         동일 에이전트 하네스 공유
라이선스           Apache 2.0          비공개 소스
할당량             일 단위             주 단위
명령어             gemini              agy

백그라운드 병렬 실행이 체감상 가장 큰 차이입니다.

# 리팩터링을 백그라운드에서 돌리면서 포그라운드에서 다른 작업 가능
agy run refactor-auth &

단, 구글이 공식적으로 인정했듯이 Gemini CLI와 1:1 기능 동등성은 아직 미완성입니다. 커스텀 동작이 많았다면 6월 18일 전에 반드시 테스트해보세요.

---

마이그레이션 체크리스트

⬜ Antigravity CLI 설치 (agy --version 확인)
⬜ 인증 완료 (로컬 OAuth 또는 CI 서비스 계정 토큰)
⬜ agy plugin import gemini 실행
⬜ MCP 설정 url → serverUrl 변경
⬜ 설정 파일 위치 .gemini/ → .agents/ 이전
⬜ Skills 디렉토리 git mv
⬜ CI/CD 스크립트 gemini → agy 전체 치환
⬜ 스테이징 환경에서 end-to-end 테스트

마지막 날 밤에 MCP 설정 문제 발견하면 꽤 난감합니다. 오늘 안에 스테이징 환경에서 한 번 돌려보는 걸 추천합니다.

---

✅ Antigravity CLI는 지금 당장 사용 가능합니다. 6월 17일까지 기다릴 이유가 없고, 조용한 MCP 실패를 발견하려면 여유 시간이 필요합니다.

❌ 기다렸다가 마이그레이션하면 복잡한 파이프라인에서 디버깅에 예상보다 오래 걸릴 수 있습니다.