길리랩blog

Gemini CLI에서 Antigravity 2.0으로 전환하는 아키텍처와 마이그레이션

Gemini CLI 종료 뒤 Go로 재작성된 Antigravity 2.0의 병렬 에이전트 구조, 플러그인 SDK, CI/CD 마이그레이션과 운영 기준을 다룬다.

2026-08-14 · 최초 발행 2026-08-02

Gemini CLI 지원 종료가 바꾼 것

Google은 2026년 6월 18일 Gemini CLI 지원을 공식 종료하고, 이후 신규 기능을 Antigravity 2.0에만 제공하기로 했다. Python으로 시작한 Gemini CLI는 실사용 과정에서 성능과 확장성 문제가 제기됐다. 멀티에이전트 병렬 처리, 대규모 코드베이스 탐색, 엔터프라이즈 플러그인 통합이 특히 약점으로 꼽혔다.

Google 내부에서는 2026년 초부터 Antigravity 프로젝트가 진행됐다. CLI 코어를 Go로 다시 설계하고 goroutine과 channel을 동시성 기반으로 삼은 작업이다. 2026년 6월 18일의 전환 발표는 이름이나 버전만 바꾼 업데이트가 아니라 실행 모델과 확장 방식을 교체한 사건에 가깝다.

⤢✕2025-Q3Gemini CLI 정식 출시2026-Q1Antigravity 프로젝트내부 개발 시작2026-05Antigravity 2.0 베타공개2026-06-18Gemini CLI 공식 종료/ Antigravity 2.0 GA2026-Q3플러그인 SDK 생태계성장 목표Gemini CLI → Antigravity 2.0 전환 타임라인

Go 재작성은 배포와 동시성을 함께 겨냥했다

정적 컴파일 언어인 Go는 단일 바이너리 배포와 크로스 컴파일이 가능하고 시작 시간이 빠르다. CLI 도구에 필요한 특성과 맞닿아 있다. Python 기반 Gemini CLI와 Antigravity 2.0의 차이는 다음과 같이 제시됐다.

비교 항목 Gemini CLI (Python) Antigravity 2.0 (Go)
콜드 스타트 시간 ~800ms ~50ms
메모리 사용량 ~120MB ~18MB
단일 바이너리 배포 불가 (pip 의존) 가능
멀티에이전트 병렬성 제한적 (GIL 영향) 네이티브 goroutine
크로스 컴파일 복잡 GOOS/GOARCH 단순 설정
플러그인 인터페이스 미제공 공개 SDK 제공

goroutine은 OS 스레드보다 가벼운 실행 단위다. Antigravity 2.0은 이를 이용해 수천 개의 에이전트 태스크를 동시에 운용하는 구조를 취한다. Task Dispatcher가 작업을 Agent Pool로 넘기고, 각 에이전트의 결과는 중앙 Aggregator를 거쳐 터미널에 출력된다. 플러그인은 별도의 Plugin Manager가 공식·커뮤니티·엔터프라이즈 확장을 연결한다.

⤢✕agy CLI 진입점Task DispatcherAgent Pool (goroutine)Agent #1: 코드 분석Agent #2: 테스트 생성Agent #3: 문서 작성Agent #N: 스케줄 태스크Result Aggregator출력 렌더러사용자 터미널Plugin Manager공식 플러그인커뮤니티 플러그인엔터프라이즈 플러그인

한 명령에서 독립 에이전트를 병렬로 돌린다

Antigravity 2.0에서는 단일 agy 명령이 여러 하위 에이전트를 동시에 생성할 수 있다. 에이전트마다 독립된 컨텍스트와 도구 접근 권한을 부여하고, 서로 다른 작업을 병렬로 실행하는 방식이다.

# 멀티에이전트 병렬 실행 예시
agy run --parallel \
  "코드베이스 전체 보안 취약점 스캔" \
  "README 및 API 문서 자동 업데이트" \
  "단위 테스트 커버리지 80% 달성 계획 수립"

각 에이전트는 별도의 goroutine에서 움직이고 channel을 통해 결과를 중앙 Aggregator에 전달한다. 에이전트 사이의 데이터 공유에는 Read-Only 스냅샷 방식을 적용해 경쟁 조건을 방지한다.

대화형 실행 외에 cron 스타일의 백그라운드 작업도 지원한다. 데몬 프로세스로 실행되는 에이전트가 지정된 주기에 태스크를 수행하고 결과를 Slack, Email, GitHub Issue 같은 채널로 전달할 수 있다.

# 매일 오전 9시 코드 품질 리포트 생성
agy schedule add --cron "0 9 * * *" \
  --task "코드 품질 분석 후 Slack #dev-report 채널에 리포트 전송" \
  --name "daily-code-quality"

# 스케줄 에이전트 목록 조회
agy schedule list

이 구조를 도입할 때는 병렬 실행 자체뿐 아니라 에이전트별 권한, 공유 데이터의 범위, 결과 집계 방식까지 운영 정책으로 다뤄야 한다.

플러그인 SDK가 확장 경계를 연다

Antigravity 2.0의 공개 플러그인 SDK는 Go 인터페이스를 기반으로 한다. 서드파티 개발자는 플러그인의 식별 정보와 명령, 초기화 및 종료 동작을 다음 인터페이스에 맞춰 구현한다.

// Antigravity Plugin SDK 핵심 인터페이스
type Plugin interface {
    Name() string
    Version() string
    Description() string
    Commands() []Command
    OnInit(ctx Context) error
    OnShutdown(ctx Context) error
}

type Command interface {
    Name() string
    Execute(ctx Context, args []string) (Result, error)
}

설치는 agy plugin install <registry-url> 명령으로 처리한다. 공식 레지스트리인 antigravity-plugins.google.com과 커뮤니티 레지스트리를 모두 지원한다.

기업 환경에서는 내부 Private Registry를 운영해 사내 보안 정책을 통과한 플러그인만 배포할 수 있다. 공식 플러그인, 오픈소스 플러그인, 내부 API와 보안 정책을 다루는 사내 플러그인이 서로 다른 레지스트리를 거쳐 같은 agy 실행 환경에 들어오는 구조다.

⤢✕개발자 워크스테이션agy CLI플러그인 레지스트리 선택공식 레지스트리antigravity-plugins.google.com커뮤니티 레지스트리github.com/agy-plugins/*엔터프라이즈 Private Registryinternal.company.com/agyGoogle 공식 플러그인(GCP, Firebase, Workspace)오픈소스 플러그인(Terraform, k8s, GitHub 등)사내 커스텀 플러그인(내부 API, 보안 정책)agy 실행 환경

플러그인 아키텍처는 모듈화, 인터페이스 설계, 의존성 역전 원칙(DIP)의 적용 사례이기도 하다. 운영 측면에서는 Private Plugin Registry와 플러그인 서명 검증이 소프트웨어 공급망 보안에 연결되고, SSO와 접근 제어는 IAM 경계에 해당한다.

기존 명령과 스크립트의 전환 범위

Antigravity 2.0에는 하위 호환을 위한 gemini-compat 레이어가 있지만, 장기적인 전환 대상은 네이티브 agy 명령이다. 일부 명령은 직접 대응하고, 일부는 이름이나 시그니처가 달라졌다.

Gemini CLI 명령 Antigravity 2.0 (agy) 대응 비고
gemini chat agy chat 직접 대응
gemini code review agy review 기능 확장됨
gemini generate agy gen 단축 명령어 추가
gemini config set agy config set 직접 대응
gemini plugin install agy plugin install SDK 완전 변경
gemini run <script> agy exec 시그니처 변경
N/A agy schedule 신규 기능
N/A agy run --parallel 신규 기능

GitHub Actions에 Gemini CLI 기반 코드 리뷰가 들어가 있다면 설치 방식과 실행 명령, 플러그인 지정까지 함께 바꿔야 한다.

# Before: Gemini CLI 기반
- name: AI Code Review
  run: |
    pip install google-gemini-cli
    gemini code review --pr ${{ github.event.pull_request.number }}

# After: Antigravity 2.0 기반
- name: AI Code Review
  run: |
    curl -sSL https://install.antigravity.google.com | bash
    agy review --pr ${{ github.event.pull_request.number }} \
      --parallel \
      --plugins security-scan,style-check

전환에 앞서 먼저 gemini 호출 위치를 grep -r "gemini " .로 전수 조사해야 한다. 커스텀 플러그인 목록과 새 SDK의 호환 여부, 환경 변수와 설정 파일 구조의 변경도 같은 인벤토리에 넣는다.

그다음 agy compat-check로 기존 스크립트의 호환성을 분석하고, 스테이징 환경에서 병렬 에이전트 태스크의 성능을 벤치마크한다. 플러그인 호환성은 자동화 테스트 스위트로 검증할 수 있다.

실제 전환은 신규 워크플로우부터 agy를 적용하면서 기존 파이프라인을 유지하는 방식으로 진행한다. 임시로 ANTIGRAVITY_COMPAT_MODE=gemini 환경 변수를 사용해 호환 레이어를 활성화하고, 전체 전환이 끝난 뒤 제거한다.

다른 AI 개발자 CLI와 비교할 때 볼 기준

2026년 AI 개발자 CLI 생태계에서 Antigravity 2.0, Claude Code, OpenAI Codex CLI는 기반 언어와 에이전트 모델, 확장 인터페이스에서 차이를 보인다.

기능 Antigravity 2.0 Claude Code OpenAI Codex CLI
기반 언어 Go Node.js Python
멀티에이전트 네이티브 지원 서브에이전트 지원 제한적
스케줄 에이전트 내장 cron 미지원 미지원
플러그인 SDK 공개 Go SDK MCP 프로토콜 미지원
오프라인 모드 제한적 미지원 미지원
컨텍스트 윈도우 Gemini 2.0 (2M) Claude 4.x (200K+) GPT-5 (128K)
엔터프라이즈 SSO 지원 지원 지원
가격 모델 사용량 기반 사용량 기반 사용량 기반

Google Cloud 중심 인프라에서 멀티에이전트 병렬 워크플로우나 스케줄 자동화가 필요하다면 Antigravity 2.0이 선택지에 들어간다. 복잡한 코드 이해와 긴 컨텍스트, VS Code·JetBrains 통합, MCP 생태계가 중심이라면 Claude Code의 조건과 맞는다. OpenAI 모델 생태계, 기존 GPT 기반 워크플로우, ChatGPT Enterprise 연동이 필요할 때는 OpenAI Codex CLI를 검토할 수 있다.

플랫폼 선택은 기능표만으로 끝나지 않는다. 기존 클라우드 전략과 IDE 사용 방식, 플러그인 거버넌스, 자동화 파이프라인의 결합 정도가 실제 전환 비용을 좌우한다.

조직 규모에 따라 달라지는 전환 속도

5인 이하의 스타트업이나 소규모 팀은 agy를 설치한 뒤 기존 스크립트를 단계적으로 교체하는 접근이 제시된다. 공개 SDK를 사용하면 팀 내부의 커스텀 워크플로우도 플러그인으로 옮길 수 있다.

50500인 규모의 중견 기업에는 68주 마이그레이션 로드맵이 필요하다. 파일럿 팀을 먼저 전환한 뒤 전사로 확대하고, Gemini CLI에 의존하는 VS Code와 IntelliJ 확장의 교체 일정도 조율해야 한다.

대기업과 엔터프라이즈 환경에서는 3~6개월 전환 계획을 세우고 Private Registry를 먼저 구축한다. 레거시 파이프라인과의 병행 운영 기간을 정하는 한편, 사내 플러그인 서명 인프라와 보안팀의 코드 감사 프로세스도 마련해야 한다.

멀티에이전트 실행은 분산 시스템의 수평 확장과 서비스 메시 개념에도 맞닿는다. 에이전트 사이에서 데이터를 공유하고 상태를 관리하는 방식은 분산 트랜잭션 설계 문제로 이어질 수 있다. CLI를 교체하는 작업으로만 보면 놓치기 쉬운 운영 경계다.

에이전트와 플러그인을 관찰하는 방법

Antigravity 2.0은 OpenTelemetry 기반 관찰 가능성을 내장 지원한다. 멀티에이전트 태스크의 분산 트레이싱, 에이전트별 실행 시간 메트릭, 플러그인 호출 통계를 Grafana와 DataDog 같은 기존 모니터링 스택에 연결할 수 있다.

# OpenTelemetry 엔드포인트 설정
agy config set otel.endpoint "http://your-collector:4317"
agy config set otel.enabled true

# 멀티에이전트 태스크 실행 시 자동으로 트레이스 전송
agy run --parallel "코드 분석" "테스트 생성"

전환 과정에서는 명령 호환성만 확인해서는 부족하다. 병렬 작업의 실행 시간, 에이전트별 실패, 플러그인 호출 상태를 함께 추적해야 새 실행 모델이 기존 파이프라인 안에서 어떻게 동작하는지 판단할 수 있다.

전환의 초점은 운영 경계에 있다

2026년 6월 18일의 Gemini CLI 종료와 Antigravity 2.0 전환은 Go 기반 네이티브 성능, 멀티에이전트 병렬 태스크, 스케줄 백그라운드 에이전트, 공개 플러그인 SDK를 한 실행 환경에 묶었다. AI CLI의 역할도 채팅 인터페이스에서 자율 개발 자동화 플랫폼으로 넓어졌다.

Gemini CLI를 CI/CD 파이프라인이나 IDE 확장에 연결해 둔 조직이라면 호출 위치와 설정부터 파악해야 한다. 엔터프라이즈에서는 플러그인 공급망 보안과 Private Registry를 먼저 다뤄야 거버넌스 공백을 줄일 수 있다.

2026년 하반기 AI CLI 생태계는 Antigravity 2.0, Claude Code, OpenAI Codex CLI를 중심으로 재편될 전망이다. 멀티에이전트 아키텍처의 성숙도와 플러그인 생태계가 플랫폼 차별화를 좌우하며, 최종 선택은 조직의 기술 스택과 클라우드 전략에 맞춰야 한다.

Sources

  • Google Antigravity 2.0 공식 발표 블로그 (2026-06-18) — developers.google.com/antigravity
  • Antigravity CLI 공식 문서 — antigravity.google.com/docs
  • "Go for CLI Tools: Why Google Chose Go for Antigravity" — Google Engineering Blog (2026-06)
  • Antigravity Plugin SDK 레퍼런스 — pkg.go.dev/antigravity.google.com/sdk
  • GitHub: google/antigravity — github.com/google/antigravity
  • "AI CLI Platforms Comparison 2026: Antigravity vs Claude Code vs Codex CLI" — The New Stack (2026-06)
  • Google Cloud Blog: "Migrating from Gemini CLI to Antigravity 2.0" (2026-06-18)
Antigravity 2.0Gemini CLI멀티에이전트GoCI/CD