반응형
Gemini CLI가 6월 18일 종료됩니다. Antigravity도 2.0으로 대규모 개편됐습니다. 기존 Antigravity 사용자라면 달라진 구조를 파악해야 하고, Gemini CLI 사용자라면 지금 바로 마이그레이션을 시작해야 합니다.
[핵심 요약 — 지금 당장 알아야 할 것]
→ Gemini CLI: 2026년 6월 18일 종료 (AI Pro·Ultra·무료 전부)
→ 대체: Antigravity CLI — 오늘부터 누구나 사용 가능
→ 마이그레이션 보존: Skills·Hooks·Subagents·Extensions(→Plugins로 리브랜딩)
→ Antigravity 2.0: 기존 IDE와 별개인 완전히 새로운 독립형 데스크탑 앱
→ 핵심 신기능: 병렬 서브에이전트 + 스케줄 태스크 + 음성 명령 + Projects
→ 기본 모델: Gemini 3.5 Flash (3.1 Pro 대비 코딩·에이전트 벤치마크 전 영역 우세, 4배 빠름)
→ Gemini Code Assist for GitHub도 6월 18일부터 신규 설치 중단
→ Enterprise Code Assist Standard/Enterprise 고객은 별도 일정 적용
무엇이 어떻게 바뀌었나 — 전체 구조 변화
기존 Antigravity는 VS Code 포크 기반 IDE 하나였습니다. 2.0부터는 세 가지 독립된 표면(surface)으로 확장됩니다.
[Antigravity 에코시스템 — 2.0 이후]
Antigravity IDE (기존 유지):
→ VS Code 포크 기반 에디터
→ 코딩 + 에이전트 인라인 명령
→ 기존 사용자 그대로 사용 가능
Antigravity 2.0 (신규 독립형 앱) ← 핵심 변화
→ IDE와 완전히 별개인 새 데스크탑 앱
→ 에이전트 오케스트레이션 전용 허브
→ 멀티 에이전트 병렬 실행·모니터링
→ 스케줄 태스크, Projects, 음성 명령
Antigravity CLI (신규, Gemini CLI 대체)
→ 터미널 전용, GUI 없음
→ 기존 Gemini CLI 기능 전부 보존
→ Antigravity 2.0과 동일한 에이전트 하네스 공유
Antigravity SDK (신규)
→ 프로그래밍으로 에이전트 하네스 제어
→ 자체 인프라에 커스텀 에이전트 배포
[IDE vs Antigravity 2.0 — 선택 기준]
Antigravity IDE 사용:
→ 코드 편집이 주 작업
→ Artifacts 시각적 검토 필요
→ 브라우저 서브에이전트 + Editor View 동시 활용
→ VS Code 경험 선호
Antigravity 2.0 사용:
→ 여러 에이전트 동시 오케스트레이션
→ 백그라운드 자동화 파이프라인
→ 멀티 레포지토리 작업
→ 에이전트 명령이 주, 코딩은 부
→ 음성으로 에이전트 지시
실전 1 — Gemini CLI → Antigravity CLI 마이그레이션
즉시 설치
# Antigravity CLI 설치 (오늘부터 누구나 사용 가능)
# npm
npm install -g @google/antigravity-cli
# 또는 공식 설치 스크립트
curl -fsSL https://antigravity.google/install.sh | bash
# 버전 확인
antigravity --version
# 로그인 (Google 계정)
antigravity auth login
기존 Gemini CLI 명령어 → Antigravity CLI 대응표
# ── 기본 실행 ─────────────────────────────────────────
# 기존 Gemini CLI
gemini "코드 리뷰해줘"
# Antigravity CLI (동일)
antigravity "코드 리뷰해줘"
# ── Skills ────────────────────────────────────────────
# 기존
gemini skills list
gemini skills run deploy-staging
# Antigravity CLI (동일)
antigravity skills list
antigravity skills run deploy-staging
# ── Hooks ─────────────────────────────────────────────
# 기존 .gemini/hooks.yaml → 동일하게 인식됨
# Antigravity CLI가 기존 .gemini/ 디렉토리 자동 감지
# ── Subagents ─────────────────────────────────────────
# 기존
gemini subagent spawn "frontend" "src/ 리팩토링"
# Antigravity CLI
antigravity subagent spawn "frontend" "src/ 리팩토링"
# ── Extensions (→ Plugins 리브랜딩) ───────────────────
# 기존
gemini extension list
gemini extension install @company/my-extension
# Antigravity CLI (이름만 변경, 동작 동일)
antigravity plugin list
antigravity plugin install @company/my-extension
# 기존 extension도 하위 호환으로 자동 인식
[마이그레이션 보존되는 것들]
✅ Agent Skills (.agents/skills/)
✅ Hooks (.gemini/hooks.yaml 또는 .antigravity/hooks.yaml)
✅ Subagents 설정
✅ Extensions → Plugins로 자동 인식
✅ GEMINI.md (그대로 사용, ANTIGRAVITY.md도 지원)
✅ 기존 config.yaml 설정 대부분
[마이그레이션 주의사항]
⚠️ Extensions 이름이 Plugins로 바뀜 (기능은 동일, 하위 호환)
⚠️ 일부 Gemini CLI 전용 실험 기능은 미지원 가능
⚠️ 6월 18일 이후에는 Gemini CLI 요청 자체가 서버에서 거부됨
→ 지금 바로 마이그레이션 시작 권장
GEMINI.md → ANTIGRAVITY.md 이전 (선택)
# 기존 GEMINI.md는 그대로 작동함
# Antigravity CLI가 자동 인식
# 신규 기능 활용하려면 ANTIGRAVITY.md 추가 생성 가능
# (GEMINI.md와 동시 사용 시 ANTIGRAVITY.md 우선)
# ANTIGRAVITY.md — 2.0 신기능 설정 예시
## 프로젝트 개요
FastAPI + React 풀스택 앱
## 스케줄 태스크 (2.0 신기능)
매일 오전 9시:
- "PR 리뷰 대기 목록 확인하고 요약해줘"
매주 월요일:
- "지난주 커밋 분석하고 기술 부채 리포트 작성해줘"
## 음성 명령 활성화
voice_commands: true
## Plugins (기존 Extensions)
plugins:
- @company/internal-jira
- @company/slack-notifier
실전 2 — Antigravity 2.0 신기능 실전 활용
스케줄 태스크 — 에이전트 자동화 파이프라인
2.0의 가장 큰 변화입니다. 에이전트를 수동으로 호출하지 않아도 정해진 시간에 자동 실행됩니다.
[Antigravity 2.0 앱에서 스케줄 태스크 설정]
1. Antigravity 2.0 앱 실행
2. 좌측 사이드바 → "Scheduled Tasks" 클릭
3. "New Schedule" → 태스크 정의
# .antigravity/schedules.yaml — 스케줄 태스크 파일
schedules:
# 매일 오전 9시 — PR 리뷰 요약
- name: daily-pr-summary
cron: "0 9 * * *"
task: |
GitHub MCP로 리뷰 대기 중인 PR 목록 가져와서
각 PR의 변경사항 요약하고
중요도 순으로 정렬해서 Slack #dev 채널에 올려줘
model: gemini-3.5-flash
sandbox: true
# 매주 월요일 오전 8시 — 기술 부채 리포트
- name: weekly-tech-debt
cron: "0 8 * * 1"
task: |
지난 한 주 커밋 분석해서:
1. 반복 수정된 파일 (불안정 코드)
2. TODO/FIXME 주석 새로 추가된 것
3. 테스트 커버리지 변화
위 내용으로 기술 부채 리포트 작성해서
TECH_DEBT.md 업데이트해줘
model: gemini-3.5-flash
# 매 커밋마다 — 보안 스캔 (Git Hook 방식)
- name: pre-push-security
trigger: git-pre-push
task: |
변경된 파일에서 하드코딩된 시크릿, SQL 인젝션 가능성,
알려진 취약 패턴 스캔해줘.
발견되면 커밋 차단하고 상세 내용 출력해줘.
sandbox: true
[스케줄 태스크 vs 기존 방식]
기존:
→ 매일 아침 직접 Antigravity 열고
→ "PR 요약해줘" 수동 입력
→ 기다림 → 결과 확인
스케줄 태스크:
→ 한 번 설정 → 이후 자동
→ 출근 전에 이미 완료
→ Slack에 결과 자동 전송
→ 주말에도 돌아감
병렬 서브에이전트 — 2.0에서 공식화
[Antigravity 2.0 앱 — 서브에이전트 실전]
기존 (Antigravity 1.x Agent Manager):
→ 사용자가 에이전트 하나씩 수동 스폰
→ 의존성 있는 작업은 순서대로 진행
Antigravity 2.0 Dynamic Subagents:
→ 오케스트레이터 에이전트가 서브에이전트를 자율 스폰
→ 복잡한 태스크를 분해 → 병렬 처리 → 결합
→ 개발자가 직접 에이전트 하나씩 스폰 안 해도 됨
[사용 예시]
입력:
"이 프로젝트를 프로덕션 배포 준비해줘"
Antigravity 2.0 자율 분해:
→ [서브에이전트 A] 보안 취약점 스캔 (병렬)
→ [서브에이전트 B] 테스트 커버리지 분석 (병렬)
→ [서브에이전트 C] 환경변수 누락 확인 (병렬)
→ [서브에이전트 D] Docker 이미지 빌드 최적화 (병렬)
→ 오케스트레이터: 4개 결과 종합 → 배포 준비 체크리스트 생성
기존 방식 대비:
→ 사용자가 4개 태스크 따로 입력 불필요
→ 오케스트레이터가 자율 판단해서 분해·병렬화
Projects — 멀티 레포지토리 + 대화 그룹화
[Antigravity 2.0 Projects]
기존:
→ 단일 디렉토리 기반 세션
→ 세션 간 컨텍스트 연결 없음
Projects:
→ 여러 레포지토리를 하나의 프로젝트로 묶기
→ 대화 히스토리 그룹화
→ 프로젝트 레벨 AGENTS.md·ANTIGRAVITY.md
→ 팀원과 프로젝트 공유 가능
사용 케이스:
→ 프론트엔드 레포 + 백엔드 레포 + 인프라 레포 통합 관리
→ 마이크로서비스 여러 개 동시 작업
→ 클라이언트별 별도 프로젝트로 분리
음성 명령
[음성 명령 활성화]
Antigravity 2.0 앱:
→ 마이크 아이콘 클릭 (또는 단축키 설정)
→ 말로 태스크 지시
→ 에이전트가 텍스트로 받아서 실행
Antigravity CLI:
→ antigravity --voice
→ 터미널에서 음성으로 지시
유용한 케이스:
→ 손이 묶여 있을 때 (다른 작업 병행)
→ 긴 태스크를 말로 설명하는 게 더 빠를 때
→ 이동 중 아이디어를 바로 에이전트에게 전달
실전 3 — Antigravity SDK 실전
기업 환경에서 에이전트 하네스를 자체 인프라에 임베딩합니다.
# pip install google-antigravity-sdk
from antigravity import AgentHarness, SubAgent, Schedule
# 기본 에이전트 생성
harness = AgentHarness(
model="gemini-3.5-flash",
sandbox="docker", # "local" / "docker" / "gcp"
credential_masking=True, # API 키 자동 마스킹
git_policy="hardened", # 위험 git 명령 보호
)
# 커스텀 서브에이전트 정의
code_reviewer = SubAgent(
name="code-reviewer",
role="시니어 개발자 코드 리뷰어",
skills=["security-scan", "performance-review"],
workspace=["src/", "tests/"],
model="gemini-3.5-flash", # 서브에이전트별 다른 모델 가능
)
doc_writer = SubAgent(
name="doc-writer",
role="기술 문서 작성자",
workspace=["docs/"],
model="gemini-3.5-flash",
)
# 병렬 오케스트레이션
result = harness.orchestrate(
task="PR #142 검토하고 문서도 업데이트해줘",
agents=[code_reviewer, doc_writer],
coordination="parallel",
on_complete=lambda r: notify_slack(r.summary)
)
# 스케줄 설정 (SDK에서도 가능)
harness.schedule(
task="매일 오전 9시 보안 스캔",
cron="0 9 * * *",
agent=code_reviewer,
sandbox=True,
)
# CI/CD 파이프라인 통합 (GitHub Actions)
# .github/workflows/ai-review.yml
# name: AI Code Review
# on: [pull_request]
# jobs:
# review:
# runs-on: ubuntu-latest
# steps:
# - uses: actions/checkout@v4
# - name: Antigravity Review
# run: |
# antigravity "PR 변경사항 보안·성능 리뷰 후 코멘트 달아줘" \
# --sandbox \
# --output json \
# --github-pr ${{ github.event.pull_request.number }}
from antigravity import AgentHarness
# CI에서 프로그래밍으로 실행
harness = AgentHarness(model="gemini-3.5-flash", sandbox=True)
result = harness.run(
task=f"PR #{pr_number} 코드 리뷰해줘",
output_format="json",
)
post_github_review(result)
실전 4 — Gemini Code Assist for GitHub 대응
[Gemini Code Assist for GitHub 변경사항]
6월 18일 이후:
→ 신규 GitHub organization 설치 중단
→ 이후 몇 주 내로 기존 요청도 서버에서 거부 시작
현재 사용 중이라면:
→ Antigravity CLI + GitHub Actions 조합으로 전환
→ 또는 GitHub Copilot, Cursor, OpenCode 등 대안 검토
Antigravity CLI로 GitHub 연동하는 방법:
→ GitHub MCP 연결 (기존 방식 그대로)
→ Antigravity CLI를 GitHub Actions에서 실행
→ PR 이벤트 트리거로 자동 리뷰 파이프라인 구성
마이그레이션 체크리스트
[Gemini CLI 사용자 — 6월 18일 전에 해야 할 것]
지금 바로:
☐ Antigravity CLI 설치 (npm install -g @google/antigravity-cli)
☐ antigravity auth login (Google 계정 연동)
☐ 기존 워크플로우 테스트 (Skills, Hooks, Subagents 정상 동작 확인)
☐ Extensions → Plugins 리브랜딩 확인 (antigravity plugin list)
6월 18일 전까지:
☐ CI/CD 파이프라인의 gemini 명령을 antigravity로 교체
☐ .env, 스크립트의 gemini 참조 일괄 교체
☐ 팀원 전체 마이그레이션 완료 확인
☐ Gemini Code Assist for GitHub 사용 중이면 대안 설정
선택 (2.0 신기능 활용):
☐ Antigravity 2.0 데스크탑 앱 설치 (antigravity.google)
☐ .antigravity/schedules.yaml 스케줄 태스크 설정
☐ Projects 기능으로 멀티 레포 통합
☐ 음성 명령 활성화
☐ GEMINI.md → ANTIGRAVITY.md 점진적 전환
마무리
✅ 지금 당장 해야 할 것
→ Gemini CLI 사용 중이면 오늘 바로 Antigravity CLI 설치
→ 6월 18일 데드라인 — 그 전에 마이그레이션 완료
→ CI/CD 파이프라인 명령어 교체 (gemini → antigravity)
→ Gemini Code Assist for GitHub 대안 확보
✅ 기존 Antigravity 사용자
→ IDE는 그대로 사용 가능
→ Antigravity 2.0 앱을 추가로 설치해서 신기능 활용
→ 스케줄 태스크로 반복 작업 자동화
→ GEMINI.md는 그대로 작동, ANTIGRAVITY.md로 신기능 추가 가능
❌ 주의
→ Antigravity 2.0 = 기존 IDE의 업데이트가 아님 (별개 앱)
→ 두 개 동시 설치해서 쓰는 것이 정상
→ Gemini CLI 6월 18일 이후 요청 자체 거부됨 (미리 이전 필수)
→ Enterprise Code Assist Standard/Enterprise는 별도 일정 확인
관련 글
- Google Antigravity 완전 가이드 1편 — 탄생 배경과 설치, 첫 세팅까지
- Google Antigravity 완전 가이드 2편 — Agent Manager로 멀티 에이전트 오케스트레이션
- Google Antigravity 완전 가이드 3편 — 브라우저 서브에이전트, 2M 토큰 인덱싱, Cloud 배포
- Google Antigravity 완전 가이드 4편 — Skills, Rules, Workflows, GEMINI.md
- Google I/O 2026 개발자 발표 총정리 2편
반응형