Google Antigravity CLI (agy) 명령어 및 설정 치트시트

**Antigravity CLI (agy)**는 Antigravity 2.0 플랫폼에 포함된 Google의 경량 Go 기반 터미널 네이티브 코딩 에이전트입니다. 병렬 서브에이전트 실행, Git worktree 격리, Agent Skills, 플러그인 및 MCP 통합을 위해 설계되었으며, 기존 일반 사용자용 Gemini CLI를 대체합니다.

이 치트시트는 agy CLI 플래그와 하위 명령어, 대화형 슬래시 명령어, 단축키, .agents/ 및 mcp_config.json 설정, 그리고 Gemini CLI 마이그레이션 단계를 다룹니다.

🔗 관련 치트시트: 터미널 AI 코딩 CLI 비교 치트시트 · Claude Code CLI 치트시트 · OpenAI Codex CLI 치트시트 · AI 에이전트 스킬 아키텍처 치트시트

---

1. 설치, 하위 명령어 및 시작 플래그

1.1 설치 및 실행

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

# 대화형 TUI 실행 (첫 실행 시 화면의 인증 안내를 따르세요)
agy

1.2 핵심 하위 명령어 및 시작 플래그

---

2. 대화형 TUI 슬래시 명령어

agy 내부에서 /를 입력해 내장 명령어를 호출하고 자동 완성할 수 있습니다.

2.1 일반, 세션 및 기록 제어

2.2 모델, 워크플로, 에이전트 및 확장 기능

---

3. 터미널 단축키 및 입력 구문

---

4. 설정 계층 구조 및 mcp_config.json

4.1 전역 범위 vs 작업 공간 범위 디렉터리 맵

⚠️ 원격 MCP 호환성 중단 스키마 (serverUrl): mcp_config.json에서 원격 HTTP MCP 서버는 기존 url이나 httpUrl 키 대신 반드시 serverUrl을 사용해야 합니다. url을 사용하면 오류 없이 조용히 연결에 실패합니다.

{
  "mcpServers": {
    "remote-docs": {
      "serverUrl": "https://docsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "local-tool": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.example.com/mcp"]
    }
  }
}

---

5. 기존 Gemini CLI에서 agy로 마이그레이션하기

Gemini CLI의 일반 사용자용 무료 티어 및 Google AI Pro/Ultra 요청 지원은 2026년 6월 18일에 종료되었습니다(기업용 Gemini Code Assist 및 종량제 API 키 워크플로만 유지). agy로의 주요 마이그레이션 매핑은 다음과 같습니다.