Gemini CLI 완전 삭제 + Antigravity CLI 설치 완벽 가이드 🚀: 2026년 6월 18일 이전에 꼭 읽어야 할 마이그레이션 매뉴얼

1 Gemini CLI, 왜 사라지는가? — 배경과 타임라인

2025년 중반, 구글은 Gemini CLI를 오픈소스(Apache 2.0)로 공개하며 개발자 커뮤니티에 큰 환영을 받았습니다. GitHub 리포지토리는 불과 몇 달 만에 10만 스타를 넘겼고, 6,000건 이상의 PR이 합병됐으며 수백 명의 외부 기여자가 코드를 다듬었습니다. Node.js 기반의 터미널 UI, 직관적인 gemini 명령어, 무료 OAuth 인증까지 — 한때 개발자 터미널의 단골 도구였습니다.

그런데 2026년에 접어들면서 상황이 바뀌었습니다. 사용자들은 단순한 단일 에이전트 채팅을 넘어 여러 에이전트가 서로 통신하며 복잡한 작업을 병렬 처리하기를 원하기 시작했습니다. 구글은 내부적으로 Gemini CLI를 개선하는 것보다, 처음부터 "에이전트 우선(agent-first)" 철학으로 설계된 새로운 플랫폼인 Google Antigravity에 모든 역량을 집중하기로 결정했습니다.

2026년 5월 19일 Google I/O 현장에서 Dmitry Lyalin(그룹 PM)과 Taylor Mullen(수석 엔지니어)이 공식 블로그를 통해 발표했습니다:

"Gemini CLI proved the terminal could be an incredible interface for agentic tasks, but your needs shifted. You now require multiple agents communicating with each other to split up the work and solve complex problems." — Google Developers Blog, 2026년 5월 19일

📅 공식 타임라인

2 Gemini CLI 완전 삭제 방법 🗑️

Antigravity CLI를 설치하기 전에 Gemini CLI를 깔끔하게 정리하는 것이 권장됩니다. 설치 방식에 따라 삭제 방법이 다릅니다. 크게 두 가지 방식이 있습니다: npx 임시 실행과 npm 전역 설치.

방법 1: npm 전역 설치로 사용한 경우

가장 일반적인 방식입니다. npm install -g @google/gemini-cli로 설치했다면 아래 한 줄로 완전히 제거됩니다.

# Gemini CLI npm 전역 패키지 제거
npm uninstall -g @google/gemini-cli

# 제거 확인 (이후에 명령어가 없다는 오류가 나와야 정상)
gemini --version

방법 2: npx로 실행한 경우 (캐시 삭제)

npx @google/gemini-cli처럼 npx를 통해 임시 실행했다면, 실제로 영구 설치가 되지 않습니다. 그러나 npx는 패키지를 캐시에 저장해 두므로, 완전히 정리하려면 npx 캐시 디렉토리를 삭제해야 합니다. 캐시 경로는 npm 설정의 `_npx` 폴더 내에 있습니다.

# npm 캐시 경로 확인
npm config get cache
# 출력 예시: /Users/yourname/.npm

# npx 캐시 삭제 (일반적으로 ~/.npm/_npx)
rm -rf "$(npm config get cache)/_npx"

echo "npx 캐시 삭제 완료"

:: npm 캐시 경로 확인
npm config get cache

:: npx 캐시 디렉토리 삭제 (일반적으로 %LocalAppData%\npm-cache\_npx)
rmdir /s /q "%LocalAppData%\npm-cache\_npx"

# npx 캐시 디렉토리 삭제
Remove-Item -Path (Join-Path $env:LocalAppData "npm-cache\_npx") -Recurse -Force

Write-Host "npx 캐시 삭제 완료"

방법 3: Homebrew로 설치한 경우 (macOS)

일부 사용자는 Homebrew를 통해 설치했을 수 있습니다. 이 경우 brew를 사용해 제거합니다.

# Homebrew를 통한 Gemini CLI 제거
brew uninstall gemini-cli

# 또는 구체적인 패키지명으로
brew uninstall @google/gemini-cli

추가 정리: 설정 파일 및 관련 디렉토리

Gemini CLI는 프로젝트 루트와 홈 디렉토리에 설정 파일을 생성합니다. Antigravity CLI도 일부 경로를 공유하므로, 아래 파일들이 충돌을 일으킬 수 있습니다. 아래 경로를 확인하고 필요에 따라 정리하세요.

# Gemini CLI 관련 설정 파일 경로 확인
# 전역 설정 (홈 디렉토리)
ls ~/.gemini/

# 프로젝트별 설정
ls .gemini/          # 현재 프로젝트 루트

# 필요시 전역 설정 백업 후 삭제
cp -r ~/.gemini ~/.gemini_backup_gemini_cli
rm -rf ~/.gemini

# 주의: ~/.gemini/antigravity 폴더가 이미 존재한다면 남겨두세요
# Antigravity가 해당 경로를 활용합니다

스크립트 및 CI/CD 파이프라인 점검

개인 작업 환경 외에도, Gemini CLI를 활용하던 자동화 스크립트가 있다면 이 시점에 같이 점검해야 합니다. 영향을 받을 수 있는 항목들입니다:

• GitHub Actions 워크플로우 파일 내 gemini CLI 호출
• cron 작업에 포함된 gemini 명령어
• shell 별칭(alias) — ~/.bashrc, ~/.zshrc 내 gemini 관련 alias
• Gemini CLI Extensions — Antigravity Plugins로 재설치 필요
• dotfiles 내 gemini 관련 환경 변수 및 설정
• 프롬프트 라이브러리 — GEMINI_SYSTEM_PROMPT 등 환경 변수

3 Antigravity CLI란 무엇인가 — 핵심 개념과 Antigravity 2.0 생태계 🌌

Antigravity CLI는 단순히 Gemini CLI의 이름만 바꾼 도구가 아닙니다. Go 언어로 완전히 재작성된 터미널 기반 AI 코딩 에이전트로, Google Antigravity 2.0 플랫폼의 핵심 구성 요소 중 하나입니다. 공식 문서에 따르면 이 도구는 "Antigravity의 경량 터미널 UI(TUI) 서페이스"로 정의됩니다. 멀티스텝 추론, 멀티파일 편집, 도구 호출, 대화 기록을 그대로 터미널로 가져온 것입니다.

🌐 Antigravity 2.0 전체 생태계

이 구조의 핵심 장점은 통합 백엔드입니다. 데스크탑 앱에 개선이 이루어지면 CLI에도 자동으로 반영됩니다. 터미널에서 시작한 대화를 데스크탑 앱으로 불러오거나, 반대로 데스크탑에서 작업하다 CLI로 전환하는 양방향 연동도 지원됩니다.

✨ Antigravity CLI의 핵심 특징

4 Gemini CLI vs Antigravity CLI — 기능 비교 📊

마이그레이션 전에 두 도구의 차이를 명확히 파악해야 합니다. 아래 표는 주요 항목별 차이를 정리한 것입니다.

5 Antigravity CLI 설치 방법 💾

Antigravity CLI는 Go 바이너리로 배포되므로 Node.js나 별도 런타임 설치 없이 단일 명령어로 설치할 수 있습니다. 운영 체제별 방법을 단계별로 안내합니다.

사전 조건

• 운영 체제: macOS, Linux, 또는 Windows 10+ (Native PowerShell, WSL 불필요)
• curl (macOS/Linux) 또는 PowerShell 5+ (Windows)
• Google 계정: 무료 계정, Pro, Ultra 모두 가능. Code Assist Standard/Enterprise 라이선스도 사용 가능.
• 기본 터미널 사용 능력: 디렉토리 탐색 및 명령어 실행 가능한 수준이면 충분.

# Antigravity CLI 설치 (macOS / Linux)
curl -fsSL https://antigravity.google/cli/install.sh | bash

# 설치 후 PATH 업데이트 (bash 사용자)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# zsh 사용자
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

# PowerShell을 관리자 권한으로 실행 후 아래 명령어 입력
irm https://antigravity.google/cli/install.ps1 | iex

# 설치 완료 후 PowerShell을 재시작하거나 아래 명령어로 경로 갱신
$env:PATH = [System.Environment]::GetEnvironmentVariable("PATH", "Machine") + ";" + [System.Environment]::GetEnvironmentVariable("PATH", "User")

# 버전 확인
agy --version
# 출력 예시: Antigravity CLI v1.x.x

# 도움말 확인
agy --help

# 현재 인증 상태 확인 (설치 후 로그인 전)
agy auth status

6 초기 인증 및 설정 🔑

설치가 완료되면 Google 계정으로 인증하고 기본 환경을 설정해야 합니다. 처음 agy를 실행하면 인터랙티브 온보딩이 시작됩니다.

# 처음 agy 실행 시 인터랙티브 온보딩이 시작됩니다
agy

# 브라우저 기반 OAuth 인증
agy auth login

# SSH 원격 환경에서는 URL이 출력됩니다 — 로컬 브라우저에서 열어 인증
# 예시: Open the following URL in your browser: https://accounts.google.com/o/oauth2/...

# 인증 완료 후 상태 확인
agy auth status

# 설정 파일 열기
agy config edit

# VS Code 또는 Cursor 설정 임포트 (선택)
agy config import --from vscode
agy config import --from cursor

# 프로젝트 폴더에서 agy 실행
cd ~/my-project
agy

# 또는 즉시 작업 지시
agy "현재 디렉토리의 README를 한국어로 번역해줘"

모델 선택 설정

Antigravity CLI는 기본적으로 Gemini 패밀리 모델을 사용하지만, 작업에 따라 모델을 변경할 수 있습니다.

# 현재 설정 확인
agy config list

# 모델 변경 예시
agy config set model gemini-3.1-pro
agy config set model claude-sonnet-4

# 프로젝트별 설정 (프로젝트 루트에 .antigravity/config.json 생성)
agy config set --project model gemini-3-flash

7 기본 사용법 — agy 핵심 명령어 실전 가이드 ⌨️

Antigravity CLI는 크게 세 가지 모드로 동작합니다: 인터랙티브 모드, 커맨드 모드, 비동기 모드. 각 모드를 언제 어떻게 사용하는지 알면 워크플로우 효율이 크게 향상됩니다.

인터랙티브 모드 (가장 일반적)

# 인터랙티브 TUI 모드로 시작
agy

# --- 내부 TUI 명령어 ---
# /help        : 사용 가능한 명령어 목록
# /clear       : 대화 기록 초기화
# /history     : 이전 대화 불러오기
# /skills      : 로드된 Skills 확인
# /tools       : 사용 가능한 도구 목록
# /settings    : 현재 설정 보기
# /export      : 현재 세션을 Antigravity 2.0 앱으로 내보내기
# Ctrl+C       : 에이전트 작업 중단 (세션 유지)
# Ctrl+D       : agy 종료

커맨드 모드 (스크립트 연동에 적합)

# 단일 작업 실행 후 종료
agy "이 프로젝트의 모든 Python 파일에서 print 문을 logging으로 교체해줘"

# 파일을 컨텍스트로 전달
agy --file ./src/main.py "이 코드의 버그를 찾아줘"

# 여러 파일
agy --file ./src/auth.py --file ./src/models.py "이 두 파일 간의 의존성을 분석해줘"

# 파이프라인 연동
cat error.log | agy "이 에러 로그에서 반복 패턴을 찾아 원인을 설명해줘"

# JSON 출력 (CI/CD 통합에 유용)
agy --output json "현재 프로젝트의 코드 품질 점수를 평가해줘"

유용한 실전 예시

# 코드 생성
agy "Flask 기반의 JWT 인증 미들웨어를 작성해줘. 코드와 테스트 코드를 포함해줘"

# 코드 리뷰
agy "현재 디렉토리의 git diff를 확인하고 잠재적 보안 문제를 분석해줘"

# 리팩토링
agy "src/ 폴더의 모든 콜백 패턴을 async/await으로 리팩토링해줘"

# 문서화
agy "이 함수들에 한국어 docstring을 추가해줘"

# 테스트 작성
agy "src/utils.py의 모든 함수에 대한 pytest 단위 테스트를 작성해줘"

# 버그 수정
agy "이 TypeScript 프로젝트를 빌드하고 오류를 모두 수정해줘"

사용량 모니터링

# 현재 사용량 확인 (무료 티어 한도 관리에 중요)
agy /usage

# 또는
agy usage

# 출력 예시:
# Daily requests: 847 / 1000
# Rate: 52 / 60 rpm

8 고급 기능: 비동기 에이전트, Skills, MCP, Hooks 🧠

Antigravity CLI가 Gemini CLI에서 한 단계 더 나아간 부분은 바로 멀티에이전트 오케스트레이션입니다. 복잡한 작업을 서브에이전트로 분할해 병렬 처리하는 것이 가능해지면서, 터미널 하나로 마치 팀 전체가 일하는 듯한 워크플로우가 구현됩니다.

🔀 동적 서브에이전트 (Dynamic Subagents)

메인 에이전트가 작업을 분석하고 필요에 따라 전문화된 서브에이전트를 즉석에서 생성해 병렬 실행합니다. 서브에이전트는 메인 에이전트의 컨텍스트 창을 공유하지 않으므로, 긴 작업에서도 컨텍스트 오염 없이 깔끔하게 작업을 분리합니다.

# 비동기 서브에이전트 활용 예시
agy "이 Python 프로젝트를 분석해서: 1) 코드 품질 점검, 2) 테스트 커버리지 분석, 3) 의존성 보안 취약점 스캔을 동시에 실행해줘"

# 위 명령어를 받은 agy는 내부적으로 3개의 서브에이전트를 병렬 실행합니다.
# 터미널이 잠기지 않으며 다른 작업을 계속할 수 있습니다.

# 진행 중인 비동기 작업 목록 확인
agy tasks list

# 특정 작업 결과 확인
agy tasks show <task-id>

# 작업 취소
agy tasks cancel <task-id>

🛠️ Agent Skills (에이전트 스킬)

Skills는 에이전트에게 특정 도메인 지식이나 반복 작업 패턴을 가르치는 기능입니다. 한 번 정의해두면 프로젝트 전반에 재사용할 수 있으며, Gemini CLI의 Agent Skills와 완전히 호환됩니다.

# 로컬 Skills 확인
agy /skills

# Skill 파일 위치: ~/.antigravity/skills/ 또는 프로젝트의 .antigravity/skills/
# Skill 파일 예시 (YAML 형식)

cat << 'EOF' > ~/.antigravity/skills/korean-docs.yaml
name: korean-docs
description: "모든 코드 주석과 문서를 한국어로 작성하는 스킬"
instructions: |
  - 모든 docstring과 주석을 한국어로 작성합니다.
  - 변수명은 영어로 유지하지만 설명은 한국어로 합니다.
  - JSDoc, Python docstring 등 언어별 표준 형식을 준수합니다.
EOF

# Skill 로드 확인
agy /skills

🔌 MCP (Model Context Protocol) 서버 연동

Gemini CLI에서 사용하던 MCP 서버는 Antigravity CLI에서도 동일하게 작동합니다. 설정 방법도 유사합니다.

// ~/.antigravity/config.json 또는 프로젝트의 .antigravity/config.json
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/dir"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "your_token_here"
      }
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://localhost/mydb"]
    }
  }
}

⚓ Hooks (JSON Hooks)

Hooks는 에이전트의 라이프사이클 단계마다 커스텀 동작을 삽입하는 기능입니다. Antigravity CLI에서는 JSON 설정 파일 방식으로 강화됐습니다.

// .antigravity/hooks.json
{
  "hooks": {
    "before_tool_call": {
      "description": "도구 호출 전 로깅",
      "script": "echo '[HOOK] Tool call: $TOOL_NAME' >> /tmp/agy-audit.log"
    },
    "after_model_call": {
      "description": "모델 호출 후 토큰 사용량 기록",
      "script": "echo '[TOKENS] Input: $INPUT_TOKENS, Output: $OUTPUT_TOKENS' >> /tmp/agy-usage.log"
    },
    "on_loop_stop": {
      "description": "에이전트 루프 종료 시 Slack 알림",
      "script": "curl -X POST $SLACK_WEBHOOK -d '{\"text\": \"agy 작업 완료!\"}'"
    }
  }
}

🧩 Plugins (기존 Extensions 대체)

Gemini CLI의 Extensions는 Antigravity Plugins로 리브랜딩됐습니다. 대부분의 기존 Extension이 동작하지만 일부는 새로운 런타임에 맞게 재테스트가 필요합니다.

# 사용 가능한 플러그인 목록
agy plugins list

# 플러그인 설치
agy plugins install @antigravity/plugin-web-search
agy plugins install @antigravity/plugin-code-runner

# Gemini CLI Extension → Antigravity Plugin 마이그레이션
# 기존 Extensions가 .gemini/extensions/ 에 있다면:
agy plugins migrate --from-gemini-extensions

9 마이그레이션 체크리스트 ✅

아래 체크리스트를 순서대로 따라가면 Gemini CLI에서 Antigravity CLI로 안전하게 이전할 수 있습니다. 프린트해서 하나씩 체크하며 진행해보세요.

10 커뮤니티 반응 및 실사용 후기 💬

Google I/O 발표 이후 개발자 커뮤니티의 반응은 복잡합니다. 기능적 개선에 대한 기대와 오픈소스 커뮤니티 문화에 대한 아쉬움이 동시에 표출되고 있습니다.

긍정적인 반응

비판적인 반응

전문가 평가 요약

DataCamp, DEV Community, Medium 등 기술 미디어의 실제 테스트 결과를 종합하면, Antigravity CLI는 아래와 같은 특성을 보입니다:

11 엔터프라이즈 사용자 안내 🏢

기업 환경에서 Gemini CLI 또는 Gemini Code Assist를 사용 중이라면, 상황이 다릅니다. Code Assist Standard 또는 Enterprise 라이선스를 보유한 조직은 이번 종료 대상이 아닙니다.

그러나 Antigravity CLI로 전환을 준비하는 기업 고객을 위해 구글은 Google Cloud 프로젝트 기반의 통합 방법을 제공하고 있습니다.

# Google Cloud 프로젝트와 연동하여 Antigravity CLI 사용 (엔터프라이즈)
agy auth login --project your-gcp-project-id

# 서비스 계정 키 기반 인증 (CI/CD 환경)
export ANTIGRAVITY_SERVICE_ACCOUNT_KEY=/path/to/key.json
agy auth service-account

# 조직 정책 준수를 위한 설정
agy config set --global data-region us  # 데이터 리전 지정
agy config set --global audit-logging true  # 감사 로그 활성화

또한 Gemini Code Assist for GitHub를 사용하는 조직의 경우, 2026년 6월 18일 이후 신규 설치가 불가능해지며 이후 몇 주 내에 요청 처리도 중단됩니다. 해당 워크플로우를 사용하고 있다면 Google Cloud를 통한 Antigravity GitHub 통합으로 이전을 검토해야 합니다.

12 마무리: 변화를 두려워할 필요 없는 이유 🌱

솔직히 말하면, Gemini CLI 종료 소식은 처음엔 당황스럽습니다. 10만 스타를 받은 오픈소스 프로젝트가 한 달도 안 되는 마이그레이션 기간을 두고 종료된다는 건 이상적이지 않습니다. 오픈소스 기여자들의 상실감도 충분히 이해됩니다.

그러나 Antigravity CLI가 제공하는 기술적 개선은 실질적입니다. Go 기반의 빠른 실행, SSH 인증 문제 해결, 비동기 멀티에이전트 오케스트레이션 — 이 세 가지만으로도 일상 개발 워크플로우가 눈에 띄게 달라집니다. 특히 원격 서버나 CI/CD 환경에서 AI 에이전트를 활용하는 팀이라면 더욱 그렇습니다.

중요한 것은 6월 18일 이전에 미리 준비하는 것입니다. 이 글의 체크리스트를 따라가면 대부분의 개인 개발자는 30분 내에 마이그레이션을 완료할 수 있습니다. 기업 환경이라면 CI/CD 파이프라인 업데이트까지 여유를 두고 지금 시작하세요.

에이전트 시대의 터미널은 이제 단순한 명령줄 인터페이스가 아닙니다. 여러 에이전트가 협력하며 코드를 작성하고, 테스트하고, 배포하는 오케스트레이션 허브로 진화하고 있습니다. Antigravity CLI는 그 방향의 첫 번째 실질적 도구입니다.