Gemini CLI에서 Antigravity CLI로 이전

한 줄 요약: Antigravity CLI 공식 문서 "Migrating from Gemini CLI". Gemini CLI의 기존 설정을 Antigravity CLI(agy)로 옮기는 방법을 다룬다. 첫 실행 때의 자동 이전, agy plugin import gemini로 확장(extension)을 플러그인으로 바꾸기, 그대로 쓰는 GEMINI.md·AGENTS.md, 바뀐 스킬 경로, mcp_config.json으로 분리된 MCP 설정과 serverUrl 키.

원본 정보#

제목: Migrating from Gemini CLI
발행: Antigravity CLI 공식 문서(antigravity.google) (원본 날짜 미상)
URL: https://antigravity.google/docs/cli/gcli-migration (새 창)
원본 출처 블록의 관련 URL: https://developers.googleblog.com/en/an-important-update-transitioning-gemini-cli-to-antigravity-cli/ (새 창) — 이 글의 본문은 원본 파일에 없다. 그 글은 따로 수집했다: Gemini CLI의 Antigravity CLI 전환 공지(2026-05-19 발행). 그 글이 링크한 이전 문서 경로(/docs/gcli-migration)는 이 원본의 URL(/docs/cli/gcli-migration)과 조금 다르다.
수집(fetch)일: 2026-10-18. 명령어, 경로, 설정 키는 이 날짜 기준이다.

핵심 주장#

Gemini CLI의 핵심 개발 경험 구성 요소와 하위 호환을 유지한다. 원본은 매끄러운 업그레이드를 위해 첫 실행 때의 자동 전환과 명시적인 CLI 이전 명령 두 가지를 준다고 말한다. 다만 "부분 호환(Partial parity)"이라는 메모로, 워크스페이스 스킬·규칙·MCP 서버는 계속 지원하지만 Gemini CLI의 일부 맞춤 터미널 테마나 실험적 시각 오버레이는 지원되지 않을 수 있다고 밝힌다. → Antigravity CLI, Gemini CLI에서 Antigravity CLI로 옮기기
첫 실행 때 기존 설정을 감지해 체크리스트로 옮긴다. 예전 설정이 있는 환경에서 agy를 처음 실행하면 기존 프로필을 자동으로 감지하고, 대화형 체크리스트로 옮길 것을 고르게 한다: 확장과 전역 설정 변환, 활성 세션 토큰을 운영체제 기본 키링(keyring)으로 이전, 기본 시각 설정과 렌더링 버퍼를 새 설정 프로필에 대응. → Gemini CLI에서 Antigravity CLI로 옮기기
확장(extension)은 이제 플러그인이다. 원본은 Gemini CLI 출시 이후 업계가 "플러그인"이라는 말로 표준화했다고 말하고, agy plugin import gemini로 예전 확장을 Antigravity 플러그인으로 직접 바꾸게 한다. 예시 출력에서 예전 명령(commands)은 스킬로 바뀌고, MCP 서버 정의는 mcp_config.json으로 옮겨진다. → 플러그인, 스킬
지시 파일은 고칠 필요가 없다. 두 CLI는 같은 워크스페이스 컨텍스트 규칙을 쓴다. 현재 디렉터리의 GEMINI.md와 AGENTS.md, 전역 ~/.gemini/GEMINI.md를 계속 읽는다. → 스키마 파일, AGENTS.md와 CLAUDE.md 함께 쓰기
바뀌는 것은 경로다. 워크스페이스 스킬은 .gemini/skills/에서 .agents/skills/로 옮겨야 슬래시 명령으로 인식된다(원본 표현 "Action required"). MCP 서버는 ~/.gemini/settings.json 안에 적던 방식에서 별도 mcp_config.json(전역 ~/.gemini/config/mcp_config.json, 워크스페이스 .agents/mcp_config.json)으로 옮기고, 원격 WebSocket·SSE 서버의 주소 키는 url·httpUrl에서 serverUrl로 바뀐다. → MCP, 스킬

원본의 명령어·경로·설정 키 (2026-10-18 기준)#

실행 명령: agy
확장 → 플러그인 변환: agy plugin import gemini. 예전 로컬 디렉터리를 찾아 확장 매니페스트를 파싱하고 파일을 Antigravity 형식으로 바꾼다. 출력 항목은 skills, agents, commands, mcpServers 넷이다.
지시 파일: 워크스페이스 GEMINI.md, AGENTS.md(현재 디렉터리), 전역 ~/.gemini/GEMINI.md
스킬 경로:

구분 Gemini CLI Antigravity CLI
전역 공유 ~/.gemini/skills/ ~/.gemini/antigravity-cli/skills/
워크스페이스 .gemini/skills/ .agents/skills/
MCP 설정: 예전 ~/.gemini/settings.json 안에 인라인 → 전역 ~/.gemini/config/mcp_config.json, 워크스페이스 .agents/mcp_config.json
원격 MCP 서버 주소 키: 예전 url 또는 httpUrl → serverUrl
원본이 다음 단계로 링크한 문서: Settings, rendering, and keybindings / Troubleshooting / CLI reference

구분	Gemini CLI	Antigravity CLI
전역 공유	`~/.gemini/skills/`	`~/.gemini/antigravity-cli/skills/`
워크스페이스	`.gemini/skills/`	`.agents/skills/`

원본에 없는 것#

Gemini CLI 지원 종료나 사용 중단 일정, 요금·플랜 정보는 이 원본에 없다. 개인 사용자 대상 종료 일정(2026-06-18)과 기업 고객 유지 방침은 Google 개발자 블로그 공지가 다룬다: Gemini CLI의 Antigravity CLI 전환 공지. 그 일정의 시행은 Gemini CLI 개인 계정 요청 처리 중단 공지(2026-06-18)가 확인한다. 이 공지는 스킬을 설치 중에 자동으로 가져온다고 말해 이 원본의 워크스페이스 스킬 "Action required"와 표현이 다르다(Gemini CLI에서 Antigravity CLI로 옮기기 4단계 상충).
기능 호환 범위를 그 공지는 "처음부터 1:1은 아니다"라고 표현하고, 유지 목록을 다르게 든다(훅·서브에이전트 포함). 이 원본도 "부분 호환(Partial parity)"이라 밝히므로 두 원본 모두 완전 호환을 말하지 않는다. 두 원본의 차이는 그 페이지의 메모에 나란히 두었다.
전역 스킬 폴더(~/.gemini/skills/)를 사용자가 직접 옮겨야 하는지, 자동 이전 체크리스트가 스킬도 옮기는지는 원본이 따로 말하지 않는다. 직접 옮기라는 "Action required"는 워크스페이스 스킬에만 붙어 있다.
지시 파일을 상위·하위 디렉터리까지 찾는지, GEMINI.md와 AGENTS.md를 어떻게 합치는지는 말하지 않는다. 이 부분은 Antigravity 공식 Rules 문서(수집 2026-10-21)가 다룬다: Antigravity 규칙 문서. 훅·서브에이전트 정의 방법도 이 원본에 없고 Antigravity 훅 문서, Antigravity 서브에이전트 문서가 다룬다.
실제 이전 사례, 걸린 시간, 실패 사례는 없다. 예시 출력의 플러그인 이름(conductor-tools, google-workspace)과 숫자는 원본의 "예상 출력" 예시다.