Gemini CLI 종료 이후 Antigravity CLI 전환과 멀티에이전트 런타임
Gemini CLI 종료와 Antigravity CLI 전환 배경, Go 기반 런타임 구조, 플러그인 마이그레이션과 CI/CD 변경점을 정리한다.
2026-08-14 · 최초 발행 2026-08-02
Gemini CLI 종료가 바꾼 것은 실행 환경이다
2026년 6월 18일 Google은 Gemini CLI와 Gemini Code Assist IDE 익스텐션의 무료·Pro·Ultra 사용자 대상 서비스를 공식 종료(EOL)했다. 같은 해 5월 19일 Google I/O 2026에서 공개된 Antigravity CLI(agy)는 그 후속 도구다.
핵심은 CLI 이름만 바뀐 것이 아니다. 기존 TypeScript·Node.js 기반 도구는 Go 기반 클로즈드소스 CLI로 재작성됐고, Agent Skills, Hooks, Subagents, Antigravity Plugins를 묶는 멀티에이전트 분산 런타임을 전면에 둔다.
Go 재작성에는 멀티에이전트 작업 분배와 연결되는 배경이 있다. 고루틴과 채널 기반 동시성 모델은 병렬 태스크에 맞고, 공식 발표에서 언급한 “snappier and more responsive”라는 응답성도 목표로 둔다. 의존성이 없는 단일 실행 파일로 배포할 수 있다는 점은 CI/CD 환경에도 맞는다.
Gemini CLI가 오픈소스였던 것과 달리 Antigravity CLI는 비공개 소스로 전환됐다. 내부 에이전트 오케스트레이션 로직을 보호하려는 목적이다. Antigravity 2.0 데스크톱 앱과 동일한 에이전트 하니스를 공유하므로, 에이전트 개선사항은 CLI에도 자동 적용되는 구조다.
스킬·훅·서브에이전트·플러그인이 나누는 책임
Agent Skills는 도메인별 능력을 주입하는 모듈 단위다. 전역 스킬은 ~/.gemini/antigravity-cli/skills/에, 워크스페이스별 스킬은 .agents/skills/에 둔다. Gemini CLI의 동일한 개념을 계승하면서 네임스페이스 구분을 강화했다.
Hooks는 에이전트 생명주기의 특정 지점을 가로챈다. 지원 이벤트는 툴 호출 전(pre-tool), 파일 편집 후(post-edit), 세션 시작 시(session-start)이며, 검증·로깅·알림 같은 횡단 관심사를 이 계층에서 처리한다.
Subagents는 메인 에이전트가 실행 중 동적으로 만들고 병렬로 실행하는 작업자다. 각각 독립된 컨텍스트 윈도우를 사용해 컨텍스트 오염을 막고, 비동기 백그라운드 작업으로 실행한 뒤 메인 에이전트에 즉시 제어권을 돌려줄 수 있다. 진행 로그는 통합 타임라인으로 스트리밍된다.
Antigravity Plugins는 기존 Extensions를 네임스페이스 디렉토리 번들로 재구성한 배포 단위다. 하나의 플러그인에 skills, rules, lifecycle hooks, MCP 서버 정의를 포함할 수 있어 팀이나 조직의 표준 에이전트 능력을 패키징하는 데 사용된다.
병렬 에이전트 작업을 격리하는 방식
멀티에이전트 시스템의 중심에는 병렬 샌드박스와 격리가 있다. Agent Teams 패널에서 서브에이전트별 역할을 지정하면, 각 작업자는 독립 샌드박스에서 병렬로 실행된다. 메인 터미널이 잠기는 방식이 아니며, 이벤트는 통합 타임라인에서 추적한다.
| 플랫폼 | 격리 기술 | 특징 |
|---|---|---|
| macOS | sandbox-exec |
Apple 샌드박스 프로파일 기반 시스템 콜 제한 |
| Linux | nsjail (네임스페이스) |
Linux 네임스페이스 + cgroup으로 프로세스 격리 |
| Windows | AppContainer |
Windows 최소 권한 컨테이너 실행 환경 |
서브에이전트는 Agent Teams 패널에서 맡은 역할을 기준으로 동작한다. 실행 상태는 Google Workspace·통신 파이프라인·클라우드 저장소 사이의 분산 자기복구 네트워크로 동기화되며, 통합 타임라인은 여러 에이전트 이벤트를 한 화면에서 보게 한다.
자연어 스케줄과 장기 목표 작업
Antigravity CLI는 내장 크론 엔진에서 자연어 기반 스케줄 지정을 처리한다.
- 반복 실행:
/schedule every hour run the health check script, up to 3 times - 지연 실행:
/schedule in 5 minutes check if the build has finished - 일일 실행:
/schedule daily at 02:00 generate dependency update PR
/goal은 결과 목표를 자연어로 선언하면 에이전트가 경로를 자율적으로 정하는 명령이다. 장기 태스크의 체크포인트와 재시도 로직도 포함한다.
의존성 취약점 점검 후 PR 생성, 야간 i18n 번역 동기화, 시간별 헬스체크 실행, 배포 완료 후 슬랙 알림처럼 사람이 반복하던 작업을 이 구조에 올릴 수 있다.
Gemini CLI 환경을 옮길 때 확인할 지점
Google은 antigravity.google/docs/gcli-migration의 마이그레이션 문서와 자동 변환 커맨드 시퀀스를 제공한다. 기본 흐름은 기존 설정을 읽어 변환 가능한 항목은 옮기고, 지원되지 않는 기능은 갭 리포트로 남긴 뒤 검증으로 이어지는 방식이다.
Agent Skills는 경로 구조를 유지하며 자동 인식되고, Hooks는 라이프사이클 이벤트 시맨틱을 유지한다. Subagents도 동일한 개념과 API 인터페이스 호환성을 계승하며, 기존 규칙 파일 형식 역시 지원한다.
다만 Google은 1:1 기능 동등성을 보장하지 않는다. 일부 Gemini Code Assist 전용 IDE 통합 기능은 임시 미지원이며, Standard/Enterprise 라이선스 사용자는 기존 Gemini CLI를 병행할 수 있다. 특정 Google Cloud 서비스 직접 통합도 Antigravity Plugins로 단계적으로 옮겨갈 예정이다.
| 변경 항목 | 기존 (Gemini CLI) | 신규 (Antigravity CLI) | 대응 방법 |
|---|---|---|---|
| CLI 명령어 | gemini |
agy |
스크립트·CI 전체 교체 |
| 플러그인 구조 | Extensions (플랫 디렉토리) | Antigravity Plugins (네임스페이스 번들) | 디렉토리 재구성 |
| 환경변수 | GEMINI_* prefix |
AGY_* prefix |
.env·시크릿 갱신 |
| 설정 경로 | ~/.gemini/ |
~/.gemini/antigravity-cli/ |
경로 마이그레이션 |
| IDE 익스텐션 | Gemini Code Assist | Antigravity IDE Plugin | 익스텐션 재설치 |
CI/CD와 플러그인 구조의 변경
CI/CD에서 가장 먼저 드러나는 변경은 gemini 명령어와 AGY_* 환경변수다. 시크릿 관리자, 컨테이너 볼륨 바인딩, 출력 파싱 로직도 함께 확인해야 한다. Go 단일 바이너리 배포는 Docker 이미지 레이어 축소 효과와 연결된다.
# Before (Gemini CLI)
- name: AI Code Review
run: gemini review --pr ${{ github.event.number }}
# After (Antigravity CLI)
- name: AI Code Review
run: agy review --pr ${{ github.event.number }}
env:
AGY_API_KEY: ${{ secrets.AGY_API_KEY }}
기존 Extension은 플랫 디렉토리였지만, 새 Plugin은 네임스페이스 아래에서 역할별 디렉토리를 갖는 번들로 바뀐다.
# 기존 Extension 구조
~/.gemini/extensions/my-plugin/
├── skill.md
└── config.json
# 신규 Antigravity Plugin 구조
~/.gemini/antigravity-cli/plugins/org.team.my-plugin/
├── skills/
│ └── skill.md
├── rules/
│ └── rules.md
├── hooks/
│ └── pre-tool.sh
├── mcp/
│ └── server.json
└── manifest.json
변환 결과는 다음 명령으로 점검한다.
agy validate --plugins: 플러그인 구조와 매니페스트 검증agy migrate --dry-run: 실제 변환 없이 갭 리포트 출력agy compat check: 기존 Gemini CLI 스크립트와 API 호환성 점검
멀티에이전트 CLI의 비교 지점
2026년 6월 기준 벤치마크에서 Antigravity CLI는 MCP Atlas 83.6%를 기록했고, Claude Code CLI와 OpenAI Codex CLI는 해당 항목을 공개하지 않았다. SWE-Bench Pro에서는 Antigravity CLI가 Flash 기준 55%, Claude Code CLI가 Opus 4.8 기준 64%다. Antigravity는 기준 대비 37% 빠른 리팩터 속도를 제시하는 반면, Claude Code는 첫 시도 테스트 통과를 강점으로 둔다.
| 벤치마크 | Antigravity CLI | Claude Code CLI | OpenAI Codex CLI |
|---|---|---|---|
| MCP Atlas | 83.6% (3사 최고) | 미공개 | 미공개 |
| SWE-Bench Pro | 55% (Flash 기준) | 64% (Opus 4.8) | 미공개 |
| 리팩터 속도 | 37% 빠름 (기준 대비) | 기준 (100%) | 미공개 |
| 테스트 통과율 | 2회 수정 필요 | 첫 시도 통과 | 미공개 |
| 구독 가격 | $20/월 | $20/월 | $20/월 |
| 항목 | Antigravity CLI | Claude Code CLI | OpenAI Codex CLI |
|---|---|---|---|
| 언어/소스 | Go, 클로즈드 | TypeScript | TypeScript |
| 기반 모델 | Gemini 3.5 Flash | Claude Opus 4.8 | GPT-4o / o3 |
| 멀티에이전트 방식 | Agent Teams + 동적 서브에이전트 + 병렬 샌드박스 | 네이티브 병렬 서브에이전트 (Opus 4.8 추가) | 비동기 태스크 위임 |
| 스케줄 에이전트 | /schedule 크론 내장 |
미지원 (외부 크론 필요) | 클라우드 실행 |
| 내장 브라우저 | Chromium 내장 (3사 유일) | 미포함 | 미포함 |
| MCP 지원 | 지원 (MCP Atlas 83.6%) | 지원 | 지원 |
| 격리 환경 | nsjail/sandbox-exec/AppContainer | 승인 기반 | 컨테이너 |
| SDK 제공 | Python SDK (공개) | 미제공 | 미제공 |
| 핵심 차별점 | 멀티에이전트 오케스트레이션 + Chromium + 스케줄드 태스크 | 최고 수준 추론 (Opus 4.8) | 비동기 태스크 + 데스크톱/IDE 확장 |
시스템 설계 원칙으로 읽는 전환
스킬·훅·서브에이전트·플러그인을 나눈 구성은 관심사 분리와 연결된다. 각 계층의 변경 영향이 제한되고, 네임스페이스 번들은 배포 단위를 분명하게 만든다.
서브에이전트를 수평으로 병렬 확장하면 태스크 처리량은 선형 증가가 가능하다. Go의 고루틴 기반 동시성은 I/O 바운드 에이전트 태스크에 맞고, 분산 자기복구 네트워크는 단일 장애점(SPOF) 제거를 겨냥한다.
독립 컨텍스트 윈도우와 플랫폼별 OS 샌드박스는 격리와 최소 권한 원칙을 구현한다. Go 단일 바이너리는 의존성 없는 배포와 Docker 이미지 경량화에, 통합 타임라인과 실행 상태 동기화는 분산 작업의 관찰가능성과 일관성 확보에 대응한다.
DevOps 작업에 적용하는 패턴
대규모 리팩터에서는 모노레포 모듈별로 서브에이전트를 배정하고 각 리팩터를 독립 샌드박스에서 병렬로 실행할 수 있다. 메인 에이전트는 다른 작업을 계속하며, 전체 상황은 통합 타임라인에서 확인한다.
여러 기술 주제를 조사할 때도 각 서브에이전트가 MCP를 통해 외부 데이터소스를 독립적으로 조회한 뒤, 메인 에이전트가 결과를 합쳐 리포트를 만들 수 있다.
DevOps 자동화에는 다음과 같은 스케줄 명령이 사용된다.
/schedule daily at 03:00 audit npm packages and create security PR/schedule every Monday at 09:00 sync i18n translations/schedule daily at 23:00 run full test suite and summarize failures
첫 명령은 일일 의존성 취약점 감사를 거쳐 GitHub PR 생성과 Slack 알림으로 이어진다. 두 번째는 주간 i18n 번역 파일 동기화 후 PR 생성과 리뷰어 자동 어사인을 처리한다. 마지막 명령은 야간 전체 테스트를 실행하고 실패 항목 요약 리포트를 다음 날 아침 팀 채널에 게시한다. Chromium 내장 브라우저를 활용하면 E2E 테스트 자동화도 단일 에이전트 안에서 다룰 수 있다.
Google Docs·Sheets·Calendar와 에이전트를 직접 연동해 Sheets 데이터를 읽고 코드를 생성하거나, Calendar 이벤트를 기반으로 스케줄드 에이전트를 실행할 수도 있다. Antigravity SDK(Python)는 이런 커스텀 Workspace 통합 개발 경로를 제공한다.