Google Antigravity CLI(agy) 명령어 총정리

Google이 2026년 5월 19일 발표한 Antigravity CLI(명령어 agy)는 Gemini CLI의 후속작입니다. Gemini CLI는 2026년 6월 18일부로 종료되었고, 개인/무료 사용자는 이제 Antigravity CLI로 넘어와야 합니다. Go로 새로 작성되어 시작 속도와 메모리 사용량이 개선됐고, Antigravity 2.0(데스크톱 앱)과 동일한 에이전트 엔진을 공유합니다.

2026년 7월 기준 프리뷰 기간이라 무료로 넉넉한 사용량 제한이 제공됩니다. 프로덕션 워크로드는 결제가 연결된 GCP 프로젝트에 연결해서 쓸 수 있습니다. 세부 옵션은 버전에 따라 바뀔 수 있으니 agy --help, 대화 중 /help로 항상 재확인하세요.

1. 설치 및 버전 확인

# macOS / Linux
curl -fsSL https://antigravity.google/cli/install.sh | bash

# Windows (PowerShell)
irm https://antigravity.google/cli/install.ps1 | iex

# 버전 확인
agy --version
# 변경 이력 확인
agy changelog

2. 최초 로그인

# 최초 실행
agy
# Welcome to the Antigravity CLI.
# You are currently not signed in.
# Select login method:
# > 1. Google OAuth
#   2. Use a Google Cloud project

개인 계정은 Google OAuth를 선택하면 브라우저가 열리고, 인증 후 코드를 복사해서 터미널에 붙여넣으면 됩니다. 조직/과금 프로젝트를 쓰려면 Use a Google Cloud project를 선택합니다. 로그인 이후 컬러 테마 선택 등 초기 설정이 이어집니다.

3. 기본 실행 모드

# 대화형 터미널 UI(TUI) 세션 시작
agy
# 비대화형 모드로 프롬프트 하나만 던지고 결과 받기 (후속 질문 불가, 자동화/스크립트용)
agy -p "Cloud Run에 배포하는 gcloud 명령어 알려줘"
# 특정 모델 지정
agy --model gemini-3.5-flash "이 함수 리팩터링해줘"
# 이전 대화 이어가기
agy --continue
agy -c
# 전체 옵션 확인
agy --help

기본 모델은 Gemini 3.5 Flash (High)입니다. 다른 프론티어 모델 대비 4배 빠르면서도 벤치마크 대부분에서 Gemini 3.1 Pro를 능가한다고 안내되어 있습니다.

4. 슬래시 명령어 총정리

명령어	기능
/help	General / Commands / Shortcuts 3개 탭으로 도움말 표시 (Tab 키로 탭 전환)
/config 또는 /settings	색상 테마, 도구 권한, 텔레메트리, 샌드박스 모드 등 설정 화면 진입
/keybindings	키보드 단축키 커스터마이징 (JSON 직접 편집도 가능)
/goal	에이전트에게 상위 목표를 지정해 여러 턴에 걸쳐 유지
/grill-me	프롬프트 앞에 붙이면 작업 시작 전에 에이전트가 먼저 확인 질문을 던짐
/schedule	프롬프트를 반복 실행되는 예약 작업(cron 등)으로 등록
/mcp	연결된 MCP 서버 관리
/agents	서브에이전트 목록/상태 확인
/plugin import gemini	기존 Gemini CLI의 확장 프로그램을 Antigravity 플러그인으로 마이그레이션
/quit	세션 종료 (또는 Ctrl+D 두 번)

5. 승인(Approval) & 샌드박스

에이전트가 터미널 명령을 실행하려 할 때 승인 프롬프트가 뜨는데, 현재 샌드박스 상태에 따라 표시되는 선택지가 달라집니다.

샌드박스 활성화 상태

기본 승인 문구에 "Yes, and run without sandbox restrictions" 옵션이 추가로 표시되어, 신뢰하는 명령 1건만 격리 없이 실행하도록 예외를 둘 수 있음.

샌드박스 비활성화 상태

반대로 "Yes, and run in sandbox" 옵션이 표시되어, 위험할 수 있는 특정 명령 1건만 강제로 격리 실행할 수 있음.

# 실행 시 플래그로 override (세션 한정, 재시작하면 설정파일 값으로 복귀)
agy --sandbox
agy --dangerously-skip-permissions

# /config 에서 확인 가능한 주요 항목 예시
# Tool Permission        request-review
# Sandbox Mode           off
# Enable Telemetry on Non-Workspace Access   off

터미널 샌드박스는 무거운 VM/컨테이너 대신 OS 네이티브 격리 기능을 씁니다: Linux는 nsjail, macOS는 sandbox-exec, Windows는 AppContainer. ~/.gemini/antigravity-cli/settings.json의 enableTerminalSandbox로 항상 켜둘 수도 있습니다.

<code"># ~/.gemini/antigravity-cli/settings.json
{
  "enableTerminalSandbox": true,
  "permissions": {
    "allow": ["git *", "npm test", "npm run build"],
    "deny": ["rm -rf *", "git push --force*"]
  }
}

글로벌 승인 레벨 대신, 위처럼 allow/deny 목록으로 명령어 단위 세밀한 권한도 지정할 수 있습니다.

6. 서브에이전트 & 백그라운드/예약 작업

Antigravity CLI는 메인 대화를 막지 않고 문서 조회, 빌드 실행, 수정사항 검증 같은 작업을 서브에이전트가 비동기·병렬로 처리하도록 자동으로 위임합니다.

<code"># 실행 중인 백그라운드 작업 확인 (자연어 질의)
> list my active tasks
# 예시 출력
# 1. task-35 · One-time Timer (600s)
# 2. task-43 · Recurring Cron (*/10 * * * *) - localhost:3000 헬스체크

단축키	기능
Ctrl + J	승인 대기 중인 다음 서브에이전트 상세 화면으로 바로 이동("teleport")
Ctrl + O	축약된 작업 목록(ManageTask 등)을 펼쳐서 보기

서브에이전트가 로컬 명령 실행이나 파일 쓰기처럼 권한이 필요한 도구를 호출하면, 메인 대화 상단에 Fast Path Alert가 뜨고 서브에이전트 상세 화면에서 개별 승인/거부할 수 있습니다.

7. 설정 파일 & 경로

파일	경로
설정 파일	~/.gemini/antigravity-cli/settings.json
키바인딩	~/.gemini/antigravity-cli/keybindings.json (삭제하면 기본값으로 초기화)

일부 설정은 --sandbox, --dangerously-skip-permissions 같은 실행 플래그로 오버라이드할 수 있습니다. 이 경우 설정 메뉴에 "Sandbox Mode on overridden by --sandbox"처럼 오버라이드 출처가 표시되며, 디스크의 영구 설정은 그대로 두고 현재 세션에서만 강제 적용됩니다.

8. Gemini CLI에서 마이그레이션

Gemini CLI를 쓰고 있었다면 Extensions, MCP 서버, Skills, 컨텍스트 파일 대부분을 그대로 가져올 수 있습니다.

# Gemini CLI 확장 프로그램을 Antigravity 플러그인으로 마이그레이션
agy plugin import gemini

개인/무료 계정은 2026년 6월 18일부로 Gemini CLI와 Gemini Code Assist 확장을 더 이상 쓸 수 없고 Antigravity CLI로 강제 전환됩니다. 다만 Gemini Code Assist Standard/Enterprise 라이선스가 있는 기업 고객은 계속 접근 가능합니다. 스크립트나 CI에서 gemini 명령어를 쓰고 있었다면 지금 agy로 바꿔주는 게 안전합니다.

9. MCP & 플러그인

<code"># 연결된 MCP 서버 확인/관리
/mcp

# Gemini CLI 확장을 플러그인으로 가져오기
agy plugin import gemini

10. 유용한 조합 정리

상황	추천 명령/설정
스크립트/자동화에서 빠르게 답만 받기	agy -p "..." (후속 질문 불가하니 단발성 질의에만)
일감을 던지기 전에 요구사항부터 확인받고 싶을 때	/grill-me를 프롬프트 앞에 붙이기
반복 실행되는 모니터링/점검 작업	/schedule로 예약 등록
딱 한 번만 격리 없이 신뢰하는 명령 실행	승인 프롬프트에서 "Yes, and run without sandbox restrictions" 선택
위험할 수 있는 명령만 강제로 격리 실행	승인 프롬프트에서 "Yes, and run in sandbox" 선택
Gemini CLI에서 넘어오는 경우	agy plugin import gemini로 확장 마이그레이션
여러 승인 대기 서브에이전트를 빠르게 순회	Ctrl + J
설정이 꼬였을 때	/config에서 오버라이드 출처 확인, 필요시 settings.json/keybindings.json 삭제 후 재생성

마무리

Antigravity CLI는 Codex CLI·Kilo CLI와 달리 서브에이전트 병렬 처리와 예약 작업(스케줄링)이 기본 내장되어 있는 게 가장 큰 차이점입니다. Gemini CLI 사용자라면 agy plugin import gemini 한 번으로 기존 확장을 옮기고, 처음 써보는 경우엔 기본값(샌드박스 off, request-review 권한)으로 시작해서 필요할 때만 /config에서 권한 범위를 조여가는 흐름을 추천합니다.