Gemini CLI 종료 대응 가이드 — 6월 18일 전에 Antigravity CLI로 마이그레이션하는 방법

2026년 5월 19일 구글은 구글 I/O에서 제미나이 CLI 종료 계획을 발표했다. 아래 표가 핵심이다.

간단히 요약하면 무료 사용자와 개인 구독자가 6월 18일 이후 제미나이 CLI를 쓸 수 없다. 기업용 Standard·Enterprise 라이선스와 유료 API 키 사용자는 영향 없다. 자신이 어느 쪽에 해당하는지 모르겠다면 지금 바로 구글 계정 설정에서 구독 현황을 확인하는 것이 첫 번째 단계다.

구글이 제미나이 CLI를 닫는 이유는 개발자 도구 전체를 안티그라비티 플랫폼 아래로 통합하기 위해서다. 제미나이 CLI는 2025년 출시 이후 깃허브에서 10만 개 이상의 별표를 받은 인기 오픈소스 도구였다. 6,000건 넘는 풀 리퀘스트가 병합됐을 정도로 커뮤니티가 활발했다. 하지만 구글 입장에서는 제미나이 CLI와 안티그라비티 CLI를 별도로 유지하기보다 하나로 통합하는 것이 전략상 유리하다고 판단한 것이다.

안티그라비티 CLI는 고 언어(Go)로 처음부터 다시 작성한 도구다. 이전 제미나이 CLI도 고 언어였지만, 이번에는 비동기 멀티에이전트 구조와 안티그라비티 플랫폼 철학에 맞게 아키텍처를 전면 재설계했다. 기존 코드베이스를 그대로 이어받은 것이 아니라 새로 만든 것이라 직접 호환되지 않는 부분이 생겼고, 그 때문에 마이그레이션 작업이 필요하다.

안티그라비티 CLI는 제미나이 CLI의 핵심 기능을 이어받았다. 초기 출시 시점에는 기능 완전 일치(feature parity)가 되지 않지만 대부분의 워크플로에서 대체가 가능하다. 가장 먼저 알아야 할 것은 명령어 이름이 바뀐다는 점이다. 터미널에서 제미나이 CLI를 실행할 때 쓰던 `gemini`라는 명령어가 `agy`로 바뀐다.

표에서 눈여겨볼 두 가지가 있다. 첫째, 프로젝트 루트에 있는 GEMINI.md 파일 이름을 AGENTS.md로 바꿔야 한다. 이 파일 안에는 에이전트에게 전달하는 프로젝트 규칙, 컨텍스트, 금지 사항 같은 내용이 들어 있다. 파일 이름만 바꾸면 되고 내부 내용은 대부분 그대로 쓸 수 있다. 둘째, 직접 만든 스킬 파일들이 있다면 기존 `.gemini/skills/` 경로에서 `.agents/skills/` 경로로 옮겨야 한다. 폴더 이름만 달라지는 것이라 파일 내용 자체는 수정 없이 재사용된다.

한 가지 아쉬운 점은 오픈소스 특성의 소멸이다. 제미나이 CLI는 소스 코드가 완전히 공개된 오픈소스 프로젝트였다. 커뮤니티가 버그를 직접 수정하고 기능을 추가할 수 있었다. 안티그라비티 CLI는 구글이 내부적으로 관리하는 클로즈드 소스이기 때문에 이런 방식의 기여가 불가능해진다. 이 부분이 오픈소스 방식에 익숙한 개발자들의 가장 큰 불만으로 꼽힌다.

마이그레이션은 전체 과정이 15분 이내로 끝난다. 4단계로 나눠 순서대로 따라가면 된다. 먼저 현재 사용 중인 제미나이 CLI 버전과 설치 방식을 파악해야 한다. 설치 방식에 따라 제거 명령어가 다르기 때문이다.

1단계 — 제미나이 CLI 제거

안티그라비티 CLI와 명령어 충돌을 막으려면 먼저 기존 제미나이 CLI를 제거하는 것이 좋다. 두 도구를 동시에 설치해도 동작하는 경우가 있지만, 깔끔하게 이전하려면 제거 후 설치하는 순서를 따르는 것이 권장된다.

2단계 — 안티그라비티 CLI 설치

구글 공식 안티그라비티 사이트(antigravity.google)에서 제공하는 설치 스크립트를 사용한다. 설치 후 구글 계정으로 로그인해야 에이전트 기능을 사용할 수 있다. 로그인은 브라우저 팝업이 뜨거나 URL을 복사해 브라우저에 붙여넣는 방식으로 진행된다.

3단계 — 설정 파일 및 스킬 경로 이전

이 단계가 마이그레이션에서 가장 실수가 많은 부분이다. 제미나이 CLI 전용 설정 파일과 스킬 파일들을 안티그라비티 CLI가 인식할 수 있는 경로와 이름으로 바꿔야 한다. 여러 프로젝트에 GEMINI.md 파일이 흩어져 있다면 아래 일괄 변경 명령이 유용하다.

4단계 — 자동화 스크립트 명령어 교체

깃허브 액션스(GitHub Actions), 젠킨스(Jenkins), 쉘 스크립트 등 자동화 파이프라인에서 `gemini` 명령어를 직접 사용하고 있다면 반드시 `agy`로 교체해야 한다. 이 부분을 놓치면 배포 파이프라인이 6월 18일 이후 갑자기 실패할 수 있다. 아래 명령어로 자동화 파일에서 `gemini` 사용 여부를 먼저 검색한 뒤 교체하면 된다.

아래 체크리스트를 6월 18일 전에 모두 통과해야 전환 작업이 완료된다. 팀 전체에 영향이 있다면 담당자를 지정해 항목별로 확인하는 것이 좋다.

• ☐ which gemini로 현재 설치 여부 확인
• ☐ 구글 계정의 구독 티어 확인 (무료·개인 구독자인지 아닌지)
• ☐ 제미나이 CLI 제거 완료
• ☐ 안티그라비티 CLI 설치 및 agy --version 확인
• ☐ agy auth login으로 구글 계정 연결 완료
• ☐ 프로젝트 내 GEMINI.md → AGENTS.md 이름 변경 완료
• ☐ .gemini/skills/ → .agents/skills/ 디렉터리 이전 완료
• ☐ 자동화 파이프라인의 gemini 명령어를 agy로 교체 완료
• ☐ 확장 플러그인 가져오기 (agy plugin import gemini) 완료
• ☐ 기본 실행(agy)으로 동작 확인

체크리스트 항목 중 특히 자동화 파이프라인 수정을 빠뜨리는 경우가 많다. 개인 로컬 환경에서는 `agy`로 잘 쓰고 있어도 원격 서버나 CI/CD 파이프라인이 옛 명령어를 쓰고 있으면 6월 18일 이후 갑자기 실패한다. 파이프라인 코드베이스 전체에서 `gemini`를 검색하는 습관이 중요하다.

안티그라비티 CLI가 마음에 들지 않거나 클로즈드 소스 방침에 동의하지 않는다면 다른 선택지를 검토할 수 있다. 현재 터미널 기반 AI 코딩 에이전트 시장은 여러 도구가 경쟁하고 있어 이전 비용이 높지 않다.

제미나이 CLI를 쓰던 이유가 구글 클라우드 플랫폼(GCP)이나 파이어베이스(Firebase)와의 연동이었다면 안티그라비티 CLI가 가장 자연스러운 대안이다. 구글 생태계 도구들과 통합이 계속 강화될 예정이기 때문이다. 반면 구글 서비스 의존도가 낮고 범용 코딩 작업이 주된 용도라면 클로드 코드나 코덱스 CLI가 더 적합할 수 있다.

오픈소스 특성을 중요하게 생각한다면 선택지가 좁아진다. 주요 터미널 에이전트 가운데 완전한 오픈소스를 유지하는 도구가 많지 않기 때문이다. 오픈클로(OpenClaw) 같은 커뮤니티 기반 에이전트 프레임워크가 대안이 될 수 있지만 직접 설치·관리해야 하는 부담이 있다.

이 글의 마이그레이션 절차와 기능 비교는 다음 공식 및 전문 자료를 근거로 했습니다. 설치 명령어의 최신 버전은 공식 사이트에서 확인하세요.

• 구글 개발자 블로그 — 제미나이 CLI → 안티그라비티 CLI 전환 공식 발표: developers.googleblog.com
• Byteiota — 안티그라비티 CLI 마이그레이션 실전 가이드(6월 18일 마감): byteiota.com
• Agentpedia — 제미나이 CLI → 안티그라비티 CLI 마이그레이션 가이드: agentpedia.codes
• TTJ 테크뉴스 — 구글 AI 개발자 도구 재편 분석: ttj.kr