Gemini CLI에서 Antigravity CLI로 옮기기

Gemini CLI에서 쓰던 지시 파일, 확장, 스킬, MCP 서버(용어 사전)를 Antigravity CLI(agy)로 옮기는 순서다. 0단계(옮겨야 하는지 판단)의 근거는 Google 개발자 블로그 공지(2026-05-19 예고)와 Google 개발자 문서(Gemini Code Assist 개인 계정 중단 안내) 등 그 뒤 시행·변경을 확인한 원본(날짜는 문장마다 표시)이고, 1~6단계의 근거는 Antigravity CLI 공식 이전 문서다(원본 날짜 미상, 수집 2026-10-18 기준). 설치 명령은 Gemini CLI 저장소 공지(2026-06-18) 기준이다. Gemini CLI의 Antigravity CLI 전환 공지, Gemini CLI 개인 계정 요청 처리 중단 공지, Gemini CLI에서 Antigravity CLI로 이전

준비물(필요한 것)#

0. 옮겨야 하는지부터 확인한다#

2026-05-19 공지는 사용자 유형에 따라 일정을 다르게 예고했다. 그 뒤 시행·변경된 내용은 날짜와 출처를 붙여 함께 적는다. Gemini CLI의 Antigravity CLI 전환 공지

• 개인 사용자: Google AI Pro·Ultra 사용자와 Gemini Code Assist for individuals로 무료로 쓰는 사용자는 2026-06-18에 Gemini CLI와 Gemini Code Assist IDE 확장의 요청 처리가 멈춘다고 예고됐다(2026-05-19 공지: 예고). Gemini CLI의 Antigravity CLI 전환 공지 → (2026-06-18 시행) Gemini CLI 저장소 공지는 이날부터 Gemini CLI가 Google AI Pro, Google AI Ultra, 무료 개인 계정의 요청 처리를 멈춘다고 밝혔다. Gemini CLI 개인 계정 요청 처리 중단 공지 Google 개발자 문서(2026-10-09 갱신)도 2026-06-18부터 IDE 확장과 Gemini CLI의 개인용 요청 처리가 멈췄고, Login with Google 옵션으로는 둘 다 접근할 수 없다고 적는다. Gemini Code Assist 개인 계정 중단 안내 Gemini Code Assist for GitHub도 같은 날부터 GitHub 조직에 새로 설치할 수 없고, 이후 몇 주 안에 요청 처리가 멈춘다고 예고됐다(2026-05-19 공지: 예고). Gemini CLI의 Antigravity CLI 전환 공지 → (2026-10-09 갱신 문서) GitHub 앱 소비자판은 2026-06-18부터 새로 설치를 마칠 수 없고, 2026-07-17에 종료돼 앱의 코드 리뷰 활동이 모두 끝났다. 엔터프라이즈판은 영향이 없다. 제거 방법은 GitHub 문서 "Deleting a GitHub app"으로 안내한다. Gemini Code Assist for GitHub 소비자판 종료 안내
• 기업 고객: Gemini Code Assist Standard·Enterprise 라이선스로 Gemini CLI나 IDE 확장을 쓰는 조직, Google Cloud를 통해 Gemini Code Assist for GitHub를 쓰는 조직은 접근이 바뀌지 않는다. 유료 Gemini API 키와 Gemini Enterprise Agent Platform API 키로도 Gemini CLI를 계속 쓸 수 있다. 원하면 Google Cloud 프로젝트로 Antigravity CLI를 쓸 수 있다(2026-05-19 기준). Gemini CLI의 Antigravity CLI 전환 공지 2026-06-18 저장소 공지도 Gemini Code Assist 라이선스를 쓰는 기업 사용자와 API 키 인증 사용자는 영향이 없다고 밝혔다(2026-06-18 기준). Gemini CLI 개인 계정 요청 처리 중단 공지 → (2026-10-13 기준) Standard·Enterprise 구독은 일정이 정해졌다. 2026-10-09부터 신규 구매가 중단됐고, 기존 구독은 계약 종료까지 계속 동작하고 지원된다. 라이선스 추가와 연간 구독 자동 갱신은 2027-01-31까지, 월간 구독 자동 갱신은 2027-12-31까지 된다. Google은 앞으로 에이전트 코딩 지원이 Gemini Enterprise 에디션에 포함된 Antigravity로 제공된다며, 최종 갱신일이나 계약 종료일 전에 Gemini Enterprise로 구독 전환을 계획하라고 권한다. 유료 API 키 사용자는 이 문서가 다루지 않는다. Gemini Code Assist Standard·Enterprise 종료 일정

2026-05-19 공지는 이전 기술 문서(http://antigravity.google/docs/gcli-migration)로 링크하고 영상 워크스루를 몇 주 안에 내겠다고 예고했다. 이 링크 경로는 위키가 수집한 이전 문서의 URL(/docs/cli/gcli-migration)과 조금 다르다. Gemini CLI의 Antigravity CLI 전환 공지

설치한다 (2026-06-18 기준)#

Gemini CLI 저장소 공지가 적은 플랫폼별 설치 명령이다. Gemini CLI 개인 계정 요청 처리 중단 공지

같은 공지는 Antigravity CLI가 설치 중에 로컬 Gemini CLI 디렉터리를 감지해 설정을 복사한다고 말한다. 항목은 스킬(직접 만든 것과 설치한 것), MCP 서버, 에이전트 프로필·구성, gemini.md 파일 호환이다. 인증 문제는 https://github.com/google-antigravity/antigravity-cli/issues (새 창) 에 알리라고 안내한다. Gemini CLI 개인 계정 요청 처리 중단 공지

1. agy를 처음 실행해 자동 이전한다#

예전 설정이 있는 환경에서 agy를 처음 실행하면 기존 프로필을 자동으로 감지하고 대화형 체크리스트를 띄운다. Gemini CLI에서 Antigravity CLI로 이전

1. 자동 변환: 변환할 확장과 전역 설정을 고른다.
2. 키링 보관: 활성 세션 토큰을 운영체제 기본 키링으로 옮긴다.
3. 설정 맞추기: 기본 시각 설정과 렌더링 버퍼가 새 설정 프로필에 자동으로 대응된다.

2. 확장을 플러그인으로 바꾼다#

확장을 직접 바꾸려면 아래 명령을 쓴다. 예전 로컬 디렉터리를 찾아 확장 매니페스트를 파싱하고 파일을 Antigravity 형식으로 바꾼다. Gemini CLI에서 Antigravity CLI로 이전

agy plugin import gemini

원본의 예상 출력:

[ok]   conductor-tools
       - skills     : skipped (none detected)
       - agents     : skipped (none detected)
       ✔ commands   : 4 legacy commands converted to skills
       - mcpServers : skipped (none detected)
[ok]   google-workspace
       ✔ skills     : 5 skills processed
       - agents     : skipped (none detected)
       ✔ commands   : 2 legacy commands converted to skills
       ✔ mcpServers : 1 server definition migrated to mcp_config.json

읽는 법: 확장마다 skills, agents, commands, mcpServers 네 항목을 보고한다. 예전 명령은 스킬로 바뀌고(converted to skills), MCP 서버 정의는 mcp_config.json으로 옮겨진다. 플러그인 이름과 숫자는 원본 예시다. Gemini CLI에서 Antigravity CLI로 이전 → 플러그인

3. 지시 파일은 그대로 둔다#

두 CLI는 같은 워크스페이스 컨텍스트 규칙을 쓰므로 기존 규칙 문서를 고칠 필요가 없다. Gemini CLI에서 Antigravity CLI로 이전

• 워크스페이스: 현재 디렉터리의 GEMINI.md, AGENTS.md
• 전역: ~/.gemini/GEMINI.md

Antigravity 공식 Rules 문서(2026-10-21 기준)는 이 파일들을 "규칙"으로 다룬다. 현재 디렉터리만이 아니라 파일을 읽거나 고칠 때 그 폴더에서 워크스페이스 루트까지 올라가며 각 단계의 AGENTS.md·GEMINI.md를 읽고, 모두 합쳐 넣으며 충돌하면 더 구체적인 디렉터리 규칙이 앞선다. 전역 위치로는 ~/.gemini/GEMINI.md 말고도 ~/.gemini/AGENTS.md, ~/.gemini/config/rules/*.md, ~/.gemini/antigravity-cli/rules/*.md를 든다. 규칙 파일 하나가 24,000바이트를 넘으면 잘린다. Antigravity 규칙 문서

→ 스키마 파일, AGENTS.md와 CLAUDE.md 함께 쓰기

4. 워크스페이스 스킬 폴더를 옮긴다#

원본은 이 단계를 "Action required"로 표시한다. 프로젝트에 .gemini/skills/가 있으면 .agents/skills/로 이름을 바꾸거나 옮겨야 Antigravity 에이전트가 활성 슬래시 명령으로 인식한다. Gemini CLI에서 Antigravity CLI로 이전

전역 스킬 폴더를 직접 옮겨야 하는지는 원본이 따로 말하지 않는다. 직접 옮기라는 표시는 워크스페이스 스킬에만 있다. Gemini CLI에서 Antigravity CLI로 이전 → 스킬

5. MCP 설정을 mcp_config.json으로 옮긴다#

Antigravity CLI는 MCP 서버를 주 설정 파일 안에 넣지 않고 별도 JSON 프로필로 둔다. Gemini CLI에서 Antigravity CLI로 이전

원격 WebSocket·SSE 서버를 손으로 옮길 때는 주소 키를 url 또는 httpUrl에서 serverUrl로 바꾼다. 원본 예시(값은 원본 예시 그대로): Gemini CLI에서 Antigravity CLI로 이전

{
    "mcpServers": {
        "remote-indexer": {
            "serverUrl": "https://mcp.internal.enterprise.com/sse",
            "env": {
                "AUTH_TOKEN": "secure_alpha_token"
            }
        }
    }
}

→ MCP

6. 부분 호환 항목을 확인한다#

원본은 워크스페이스 스킬, 규칙, MCP 서버는 계속 지원하지만 Gemini CLI의 일부 맞춤 터미널 테마나 실험적 시각 오버레이는 지원되지 않을 수 있다고 말한다. 원본은 다음 단계로 Settings(단축키·테마·화면 버퍼), Troubleshooting(인증 잠김·경로 문제), CLI reference(파라미터·슬래시 명령 대응) 문서를 링크한다. Gemini CLI에서 Antigravity CLI로 이전

공지(2026-05-19)는 유지 목록을 다르게 든다(훅·서브에이전트 포함). 처음부터 기능이 1:1로 같지는 않다고 밝히면서, 유지하는 핵심 기능으로 Agent Skills, Hooks, Subagents, Extensions(플러그인)를 든다. 1:1이 아닌 기능의 구체 목록은 공지에 없다. 두 원본 모두 부분 호환이고 유지 목록만 다르다. 차이는 Antigravity CLI의 메모에 나란히 두었다. 공지는 이전 중 필요한 기능 요청을 커뮤니티 포럼(https://github.com/google-antigravity/antigravity-cli)에 (새 창) 남기라고 안내한다. Gemini CLI의 Antigravity CLI 전환 공지

공지가 유지 기능으로 든 훅은 Antigravity 공식 Hooks 문서(수집 2026-10-21)에 정의 방법이 있다. CLI는 워크스페이스 .agents/hooks.json, 전역 ~/.gemini/config/hooks.json 또는 ~/.gemini/antigravity-cli/settings.json 안, 플러그인의 hooks.json에서 훅을 읽고, 옮긴 뒤 TUI에서 /hooks로 로드된 훅을 확인할 수 있다. 다만 이 문서는 Gemini CLI에서 쓰던 훅을 옮기는 방법은 말하지 않는다. Antigravity 훅 문서 → 훅

서브에이전트도 Antigravity 공식 서브에이전트 문서(수집 2026-10-21)에 정의 방법이 있다. 사용자 서브에이전트는 워크스페이스 .agents/agents/<name>.md, 전역 ~/.gemini/config/agents/에 Markdown+YAML frontmatter로 두고, CLI에서 /agents로 확인한다. agy plugin import gemini 출력의 agents 항목이 이 위치로 옮겨지는지, Gemini CLI의 에이전트 정의를 어떻게 바꾸는지는 이 문서에 없다. Antigravity 서브에이전트 문서 → 서브에이전트

됐는지 확인하는 법#

• 확장 변환: agy plugin import gemini는 확장마다 [ok]와 함께 skills, agents, commands, mcpServers 네 항목의 처리 결과를 보여 준다(2단계의 예상 출력). skipped (none detected)는 그 항목이 없었다는 뜻이고, 숫자는 원본 예시다. Gemini CLI에서 Antigravity CLI로 이전
• 스킬: 이전 문서에는 스킬을 확인하는 명령이 따로 없다. 워크스페이스 스킬은 .agents/skills/에 있어야 활성 슬래시 명령으로 인식된다고만 말한다(4단계). 4단계 상충 콜아웃의 편집자 해석처럼 옮긴 뒤 그 폴더에 스킬이 있는지 직접 본다. Gemini CLI에서 Antigravity CLI로 이전
• 훅 (2026-10-21 기준): TUI(터미널 화면)에서 /hooks를 입력하면 로드된 활성 훅을 볼 수 있다. Antigravity 훅 문서
• 서브에이전트 (2026-10-21 기준): /agents를 입력하면 Agent Manager 패널이 열리고, 에이전트 목록과 사용자 에이전트 선택이 보인다. Antigravity 서브에이전트 문서
• MCP·지시 파일·테마: 이전 문서에는 확인 방법이 따로 없다. 인증 잠김·경로 문제는 Troubleshooting 문서로 넘기는데, 위키에 이 사이트에서 아직 다루지 않는다(6단계). 인증 문제는 Antigravity CLI GitHub 이슈에 알리라고 저장소 공지는 안내한다. Gemini CLI에서 Antigravity CLI로 이전 · Gemini CLI 개인 계정 요청 처리 중단 공지

언제 쓰고 언제 쓰지 않는가#

• 쓴다: Gemini CLI 설정(확장, .gemini/skills/, settings.json의 MCP 서버)이 있는 환경을 Antigravity CLI로 옮길 때. 특히 2026-06-18부터 Gemini CLI 요청 처리가 멈춘 개인 플랜·무료 사용자일 때(2026-05-19 예고, 2026-06-18 시행). Gemini CLI의 Antigravity CLI 전환 공지, Gemini CLI 개인 계정 요청 처리 중단 공지 Gemini CLI 기준으로 만든 교육 자료·사내 가이드의 경로 예시를 고칠 때(편집자 해석: 원본이 예전 경로와 새 경로를 나란히 주므로 바꿀 곳 목록으로 쓸 수 있다).
• 쓰지 않는다: 이전 문서는 Gemini CLI 설정이 없는 새 환경의 설치·초기 설정을 다루지 않는다. 그 경우는 이전 문서가 링크한 Settings·CLI reference 문서를 봐야 한다. Gemini CLI에서 Antigravity CLI로 이전
• 당장 서두르지 않아도 되지만 계획은 세울 경우(편집자 해석): Standard·Enterprise 라이선스로 Gemini CLI를 쓰는 조직은 기존 구독이 계약 종료까지 지원되므로 지금 바로 옮겨야 한다는 근거는 원본에 없다고 볼 수 있다. 다만 2026-10-13 기준 Google은 "최종 갱신일이나 계약 종료일 전에" Gemini Enterprise(Antigravity 포함)로 전환을 계획하라고 권하므로, 각 조직은 자기 계약의 최종 갱신일이나 계약 종료일을 기준으로 전환 일정을 잡는 것으로 볼 수 있다(근거: 원본의 "plan your subscription transition to Gemini Enterprise before your plan reaches its final renewal or contract end date"). 별도 사실로, 라이선스 추가와 연간 구독 자동 갱신은 2027-01-31까지, 월간 구독 자동 갱신은 2027-12-31까지만 된다. Gemini Code Assist Standard·Enterprise 종료 일정 유료 API 키 사용자는 2026-06-18 기준 영향이 없다고 했고 그 뒤 일정은 위키에 근거가 없다. Gemini CLI 개인 계정 요청 처리 중단 공지