Gemini CLI 설정을 통째로 복사하는 방식은 빠르지만, 실제로는 확장·스킬·MCP·인증의 목적지가 서로 다릅니다. 2026년 8월 31일 기준 Google은 Antigravity CLI를 agy로 실행하는 공식 제품으로 제공하고, Gemini CLI용 자산을 가져오는 절차도 문서화했습니다. 핵심은 “파일을 몇 개 옮겼는가”가 아니라, 필요한 기능이 새 권한 경계 안에서 다시 작동하는가입니다.
먼저 옮길 것과 다시 만들 것을 나눕니다
| 항목 | 권장 처리 | 확인할 결과 |
|---|---|---|
| 프로젝트 규칙 | 자동 감지 후 내용 검토 | 현재 저장소 규칙만 적용되는가 |
| Gemini 확장 | agy plugin import gemini로 변환 |
스킬·명령·MCP 처리 결과가 표시되는가 |
| 스킬 | 새 경로와 중복 여부 점검 | 호출 이름과 참조 파일이 유효한가 |
| MCP | 새 스키마로 변환 후 재인증 | 서버 URL·전송 방식·환경 변수가 맞는가 |
| 로그인 정보 | 직접 복사하지 않음 | OS 키링 또는 새 OAuth로 연결되는가 |
| 테마·실험 UI | 보류하거나 폐기 | 공식 가이드의 부분 호환 범위인가 |
Google의 마이그레이션 안내는 첫 실행 때 기존 프로필을 감지해 선택적으로 변환하고, 수동 변환 명령도 제공한다고 설명합니다. 다만 커스텀 터미널 테마와 실험적 화면 설정은 완전 대응하지 않을 수 있습니다. 변환 성공 메시지는 형식 변환이 끝났다는 뜻이지, 모든 동작이 동일하다는 보장은 아닙니다.
설치부터 작은 검증까지 네 단계로 진행합니다
1. 공식 설치 경로를 사용합니다. macOS·Linux는 설치·인증 문서의 현재 명령을 복사합니다.
curl -fsSL https://antigravity.google/cli/install.sh | bash
agy --versionWindows는 같은 문서의 PowerShell 또는 CMD 명령을 사용합니다. 설치 스크립트는 바뀔 수 있으므로 블로그에 복제된 명령보다 공식 페이지를 다시 확인하는 편이 안전합니다.
2. 첫 실행에서 범위를 줄입니다. 폐기 가능한 샘플 저장소에서 agy를 실행하고, 기존 설정 중 실제로 쓰는 항목만 선택합니다. 폴더 신뢰 화면이 나타나면 출처와 경계를 확인합니다. 홈 디렉터리 전체를 첫 작업공간으로 지정하지 않습니다.
3. 변환 로그를 자산별로 읽습니다. 온보딩을 건너뛰었거나 확장을 다시 가져올 때는 다음 명령을 사용합니다.
agy plugin import gemini출력에서 commands가 skills로 변환됐는지, MCP 정의가 생성됐는지, 건너뛴 항목은 무엇인지 기록합니다. 토큰과 인증 헤더는 저장소나 마이그레이션 메모에 붙여 넣지 말고 새 환경에서 다시 인증합니다.
4. 읽기→한 줄 수정→짧은 테스트 순서로 확인합니다. 먼저 파일을 바꾸지 않고 규칙과 폴더 구조만 설명하게 합니다. 다음에는 문서 한 줄처럼 즉시 되돌릴 수 있는 변경의 diff를 검토합니다. 마지막으로 짧은 테스트 하나를 실행해 작업 위치, 명령과 결과를 확인합니다. 예상 밖 경로 접근, 광범위한 셸 허용, 비밀정보 요청이 나오면 이전을 중단합니다.
완료 기준은 재현 가능한 한 작업입니다
이전 완료는 다음 네 항목이 모두 확인된 때입니다. 규칙이 올바른 범위에서 읽히고, 필요한 플러그인·스킬·MCP만 보이며, 작은 변경의 diff를 사람이 검토할 수 있고, 같은 테스트를 다시 실행해 같은 종류의 결과를 얻어야 합니다. 확인하지 못한 테마·별칭·실험 옵션은 “미완료”가 아니라 “의도적 보류”로 기록합니다. 이 표가 있으면 이후 오류를 설치, 경로, 인증, 권한 중 하나로 빠르게 좁힐 수 있습니다.