이 페이지의 목차
확인 2026-05-19근거 자료 8건갱신 2026-10-26언급 17곳
이 페이지의 목차

터미널에서 쓰는 에이전트 CLI(명령줄 프로그램, 용어 사전)로, 명령은 agy다. 공식 문서는 antigravity.google에 있다. 원본은 Gemini CLI가 대중화한 핵심 개발 경험 구성 요소와 하위 호환을 유지한다고 말한다. Gemini CLI에서 Antigravity CLI로 이전

Google 개발자 블로그 공지(2026-05-19)는 Antigravity CLI를 에이전트 우선 개발 플랫폼 Google Antigravity의 새 터미널 경험으로 소개한다. Google Antigravity에는 서버 측 하네스와 이 CLI가 들어 있고, Google은 Gemini CLI에 쏟던 노력을 이 플랫폼 하나로 모은다고 밝혔다. (2026-05-19 기준) 공지 발행일부터 누구나 쓸 수 있고(다운로드 https://antigravity.google/download (새 창)), 기업은 Google Cloud 프로젝트로 쓸 수 있다. 기능 요청과 피드백 창구는 커뮤니티 포럼 https://github.com/google-antigravity/antigravity-cli (새 창) 다. Gemini CLI의 Antigravity CLI 전환 공지 Gemini CLI 저장소 공지(2026-06-18)는 Antigravity CLI를 통합된 에이전트 우선 터미널 경험으로 부르고, 데스크톱 플랫폼과 백엔드 하네스를 공유해 복잡한 작업을 실행한다고 말한다. 같은 날 Gemini CLI는 개인 계정(Google AI Pro·Ultra, 무료)의 요청 처리를 멈췄다. Gemini CLI 개인 계정 요청 처리 중단 공지 Google 개발자 문서(2026-10-09 갱신)는 Gemini CLI·IDE 확장의 개인 계정 사용자가 Antigravity 제품군으로 옮길 수 있다고 하고, 할당량·구독 정보는 https://antigravity.google/pricing (새 창) 으로, Antigravity CLI 문제는 위 커뮤니티 포럼과 같은 GitHub 저장소(https://github.com/google-antigravity/antigravity-cli)로 (새 창) 안내한다. Gemini Code Assist 개인 계정 중단 안내 기업 쪽은 Google Cloud 문서(2026-10-13 갱신)가 앞으로 에이전트 코딩 지원이 Gemini Enterprise 에디션에 포함된 Antigravity로 제공된다고 말하고, Gemini Code Assist Standard·Enterprise 구독자에게 최종 갱신일이나 계약 종료일 전에 Gemini Enterprise로 구독 전환을 계획하라고 권한다. 이 문서는 Antigravity CLI라는 이름은 이전 가이드 링크에서만 쓴다. Gemini Code Assist Standard·Enterprise 종료 일정

확인 날짜 안내

확인 날짜가 섞인 페이지다. 이전 관련 경로·명령어·설정 키는 이전(migration) 문서(원본 날짜 미상, 수집 2026-10-18) 기준이고, 설치 명령은 Gemini CLI 저장소 공지(2026-06-18) 기준, 전환 배경·내세우는 특징·유지 기능 목록·이용 조건은 공지(2026-05-19 발행) 기준이다. 훅·서브에이전트·규칙 절은 Antigravity 공식 문서(원본 날짜 미상, 수집 2026-10-21) 기준이다. 페이지 확인 날짜는 2026-05-19다. 발행일부터 누구나·기업은 Google Cloud 프로젝트로 쓸 수 있다는 이용 조건을 아직 그 공지만 확인하기 때문이다. 벤더 공지가 내세운 홍보성 주장(Go로 만들어 빠르다, Gemini CLI 용도를 그대로 할 수 있다, 핵심 개선이 자동 반영된다)은 "(공지 주장)"으로 표시하고 날짜 계산에서 뺀다. 일반 사용법, 설정, 명령 목록은 이전 문서가 링크만 한 Settings·Troubleshooting·CLI reference 문서를 수집한 뒤 채운다.

설치 (2026-06-18 기준)#

Gemini CLI 저장소 공지가 적은 플랫폼별 설치 명령이다. Gemini CLI 개인 계정 요청 처리 중단 공지

플랫폼명령
macOS·Linuxcurl -fsSL https://antigravity.google/cli/install.sh | bash
Windows PowerShellirm https://antigravity.google/cli/install.ps1 | iex
Windows 명령 프롬프트curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd

같은 공지는 설치 중에 로컬 Gemini CLI 디렉터리를 감지해 스킬(직접 만든 것과 설치한 것), MCP 서버, 에이전트 프로필·구성을 옮기고 gemini.md 파일과 완전히 호환한다고 말한다. 워크스페이스 스킬을 직접 옮겨야 한다는 이전 문서와의 차이는 Gemini CLI에서 Antigravity CLI로 옮기기 4단계의 상충 콜아웃에 나란히 두었다. Gemini CLI 개인 계정 요청 처리 중단 공지

공지가 내세운 특징 (2026-05-19 기준)#

공지는 전환 이유로, 사용자에게 여러 에이전트가 서로 소통하며 일을 나눠 복잡한 문제를 푸는 방식이 필요해졌고 그래서 터미널 도구도 나머지 워크플로와 같은 백엔드를 써야 한다는 점을 든다. Gemini CLI의 Antigravity CLI 전환 공지

Gemini CLI에서 계속 지원되는 것#

두 원본이 유지 범위를 다르게 적는다. 아래 메모에 나란히 둔다.

  • 공지가 든 유지 기능 (2026-05-19 기준): Agent Skills, Hooks, Subagents, Extensions(이제 Antigravity 플러그인). 빠른 근거 기반 답변, 새 코딩 프로젝트 뼈대 만들기, 클라우드 인프라 프로비저닝 같은 Gemini CLI 용도도 Antigravity CLI에서 그대로 할 수 있다고 말한다(공지 주장). 훅·서브에이전트를 어떻게 정의하고 어디에 두는지는 공지에 없다. Gemini CLI의 Antigravity CLI 전환 공지 그 뒤 수집한 공식 문서(수집 2026-10-21)가 훅과 서브에이전트의 정의 방법을 적는다(아래 "훅"·"서브에이전트" 절). Antigravity 훅 문서, Antigravity 서브에이전트 문서 → 스킬, 훅, 서브에이전트, 플러그인

이전 문서 기준(2026-10-18):

  • 지시 파일(그대로 쓴다): 두 CLI는 같은 워크스페이스 컨텍스트 규칙을 쓰고, 기존 규칙 문서는 고칠 필요가 없다. 현재 디렉터리의 GEMINI.md와 AGENTS.md, 전역 ~/.gemini/GEMINI.md를 읽는다. 원본은 이 파일들의 규칙 제약을 에이전트가 "parse and enforce"한다고 표현한다. Gemini CLI에서 Antigravity CLI로 이전 → 스키마 파일 탐색 범위와 합치는 방식은 공식 Rules 문서(2026-10-21 기준)에 있다(아래 "규칙(지시 파일)" 절).
  • 워크스페이스 스킬·규칙·MCP 서버: 지원이 유지된다. 다만 스킬과 MCP 서버는 위치와 형식이 바뀐다(아래 "달라진 것" 표). 원본은 "부분 호환"이라고 밝히고, Gemini CLI의 일부 맞춤 터미널 테마나 실험적 시각 오버레이는 지원되지 않을 수 있다고 말한다. Gemini CLI에서 Antigravity CLI로 이전

Gemini CLI와 달라진 것 (2026-10-18 기준)#

항목Gemini CLIAntigravity CLI
확장 단위 이름확장(extension)플러그인(plugin)
전역 스킬~/.gemini/skills/~/.gemini/antigravity-cli/skills/
워크스페이스 스킬.gemini/skills/.agents/skills/
MCP 서버 설정~/.gemini/settings.json 안에 인라인별도 mcp_config.json. 전역 ~/.gemini/config/mcp_config.json, 워크스페이스 .agents/mcp_config.json
원격(WebSocket·SSE) MCP 서버 주소 키url 또는 httpUrlserverUrl
세션 토큰 보관(원본에 예전 방식 설명 없음)첫 실행 이전 때 운영체제 기본 키링으로 옮김

근거: Gemini CLI에서 Antigravity CLI로 이전

  • 워크스페이스 스킬은 자동으로 따라오지 않을 수 있다. 원본은 .gemini/skills/에 스킬이 있으면 폴더를 .agents/skills/로 직접 이름을 바꾸거나 옮겨야 Antigravity 에이전트가 활성 슬래시 명령으로 인식한다고 말한다("Action required"). Gemini CLI에서 Antigravity CLI로 이전 → 스킬
  • 원본은 MCP 서버를 주 설정 파일 안에 넣지 않고 전용 경량 JSON 프로필로 분리했다고 설명한다. Gemini CLI에서 Antigravity CLI로 이전 → MCP

훅 (2026-10-21 기준)#

Antigravity 공식 Hooks 문서는 CLI가 훅을 세 곳에서 읽는다고 말한다: 워크스페이스 .agents/hooks.json(프로젝트 루트), 전역 ~/.gemini/config/hooks.json 또는 ~/.gemini/antigravity-cli/settings.json 안, 설치한 플러그인의 hooks.json. TUI에서 /hooks를 입력하면 로드된 훅을 볼 수 있다. 훅 입력의 <app_data_dir>은 CLI에서 ~/.gemini/antigravity-cli다. Antigravity 훅 문서

항목내용
이벤트SessionStart, PreToolUse, PostToolUse, PreInvocation, PostInvocation, Stop
matcherPreToolUse·PostToolUse에서만. 도구 이름 정규식(예: run_command, browser_.*)
핸들러type은 지금 command만 지원, command 필수, timeout 기본 30초
끄기훅 이름 아래 enabled: false
입출력stdin·stdout JSON, camelCase. PreToolUse는 decision으로 허용·자동 승인·거부·확인 요청 등을 고른다

근거: Antigravity 훅 문서. 이벤트별 필드와 막는 훅의 조건·한계는 훅의 "다른 도구에서" 절에 있다.

서브에이전트 (2026-10-21 기준)#

Antigravity 공식 서브에이전트 문서 기준이다. 주 에이전트는 invoke_subagent 도구로 서브에이전트를 띄우고, 사용자 정의 서브에이전트는 YAML frontmatter와 본문(시스템 프롬프트)으로 된 Markdown 파일로 만든다. CLI는 워크스페이스 .agents/agents/<name>.md 또는 .agents/agents/<name>/agent.md, 전역 ~/.gemini/config/agents/에서 이 파일을 자동으로 찾는다. 원본 앞쪽 App 절의 위치 표는 플러그인 plugins/<plugin_name>/agents/도 든다. subagent: true인 에이전트는 주 에이전트가 부를 수 있고, /agents 패널에서 주 에이전트로 직접 고를 수도 있다. 내장 서브에이전트는 research, browser, self다. Antigravity 서브에이전트 문서

frontmatter 필드기본값뜻
name, description(필수)식별자, 플래너가 언제 맡길지 정하는 설명
tools[]허용 도구 목록(예: view_file, grep_search, run_command)
mainAgenttrue채팅에서 주 에이전트로 고를 수 있는지
subagenttrueinvoke_subagent로 부를 수 있는지
modelinheritinherit, flash, pro
commandExecutionPolicysandbox셸 명령 자동 실행 정책 off, auto, eager, sandbox
mcpServers[]이 서브에이전트용 MCP 서버
skills / plugins[]스킬 경로(예: skills/my-helper-skill)나 플러그인 의존성

근거: Antigravity 서브에이전트 문서. 알려진 문제로, tools에 없는 도구 이름이나 오타를 쓰면 서브에이전트가 실행 중 멈출 수 있다고 원본이 적는다.

CLI 명령·키하는 일
/agentsAgent Manager 패널. 백그라운드 에이전트의 ID·역할·상태·현재 단계, Enter로 상세 보기
/tasks셸 명령·테스트·/btw 조회 같은 에이전트가 아닌 백그라운드 작업 목록과 로그, 종료
Alt+J승인을 기다리는 다음 서브에이전트의 상세 보기로 이동
Ctrl+K프롬프트 위 알림에 뜬 대기 동작을 패널을 바꾸지 않고 승인
k실행 중인 서브에이전트 취소

근거: Antigravity 서브에이전트 문서

원본은 멀티 에이전트 오케스트레이터 두 가지를 링크한다. /boost(3계층 추론 구조로 어려운 버그·리팩터링)는 Google One AI Premium(Pro·Ultra 등급)과 Enterprise 플랜에서, /teamwork-preview(전문 에이전트 팀으로 큰 프로젝트)는 유료 플랜에서 App과 CLI에 제공된다고 적는다(플랜 이름은 원본 표기). 세부는 별도 문서로 넘긴다. Antigravity 서브에이전트 문서

권한 상속, 중첩 10단계, 상태(Running·Idle·Killed) 같은 동작과 조건은 서브에이전트의 Antigravity 절에 있다.

규칙(지시 파일) (2026-10-21 기준)#

Antigravity 공식 Rules 문서 기준이다. 규칙은 코딩 표준·아키텍처 제약처럼 계속 지킬 지시로, Antigravity가 파일 시스템에서 찾아 에이전트 컨텍스트에 넣는다. 원본은 제약·불변 조건은 규칙으로, 여러 단계 워크플로는 스킬로 쓰라고 권한다. Antigravity 규칙 문서

CLI가 읽는 위치(원본 CLI 절):

  • 워크스페이스·디렉터리: 저장소 루트나 하위 디렉터리의 AGENTS.md, GEMINI.md, .agents/rules/*.md. 공통 절은 각 디렉터리의 .agents/AGENTS.md·.agents/GEMINI.md와 예전 .agent/rules/*.md도 든다.
  • 전역: ~/.gemini/AGENTS.md, ~/.gemini/GEMINI.md, ~/.gemini/config/rules/*.md, ~/.gemini/antigravity-cli/rules/*.md. 공통 절은 ~/.gemini/config/AGENTS.md·~/.gemini/config/GEMINI.md도 단독 전역 파일로 든다.
  • 플러그인: 설치한 플러그인의 ~/.gemini/antigravity-cli/plugins/<plugin_name>/rules/를 자동으로 활성화한다.

탐색과 합치기: 파일을 읽거나 고칠 때마다 그 파일의 폴더에서 워크스페이스 루트까지 디렉터리 트리를 올라가며 각 단계의 규칙을 로드한다. 규칙은 대체가 아니라 누적이라 전역·워크스페이스·디렉터리 규칙을 모두 프롬프트에 합치고, 지시가 충돌하면 더 구체적인 디렉터리 규칙이 앞선다. Antigravity 규칙 문서

항목내용
frontmatterAGENTS.md·GEMINI.md는 쓰지 않고 항상 활성. rules/*.md는 trigger 필수. 없거나 값이 틀리면(예: alwaysOn) 조용히 버려진다
triggeralways_on, model_decision(경로·description만 먼저 넣음), glob(globs 패턴 파일을 다룰 때), manual(@ 언급 때만)
폴더.agents/rules/는 바로 아래 .md만. 하위 폴더는 .agents/rules.json에 등록해야 읽는다
파일 참조@[label](path)는 내용을 펼쳐 넣고, @filename은 펼치지 않고 절대 워크스페이스 경로로 바꾼다
크기파일당 24,000바이트를 넘으면 잘림. 전역·always_on 규칙 합계 20,000토큰을 넘으면 큰 파일부터 포인터로 바뀜

근거: Antigravity 규칙 문서. 다른 도구와 같은 저장소에서 쓸 때는 AGENTS.md와 CLAUDE.md 함께 쓰기의 Antigravity CLI 절.

플러그인 (2026-10-18 기준)#

원본은 Gemini CLI 출시 이후 업계가 "플러그인"이라는 말로 표준화했다고 말한다. 예전 Gemini 확장은 아래 명령으로 Antigravity 플러그인으로 바꾼다. Gemini CLI에서 Antigravity CLI로 이전

agy plugin import gemini

이 명령은 예전 로컬 디렉터리를 찾아 확장 매니페스트를 파싱하고, 파일을 Antigravity 형식으로 바꾼다. 원본의 예상 출력에서 각 확장은 skills, agents, commands, mcpServers 네 항목으로 보고되고, 예전 명령은 스킬로, MCP 서버 정의는 mcp_config.json으로 옮겨진다. Gemini CLI에서 Antigravity CLI로 이전 → 플러그인

옮기는 전체 절차: Gemini CLI에서 Antigravity CLI로 옮기기

다른 도구와 함께 볼 때 (편집자 해석)#

  • 지시 파일: Antigravity CLI가 AGENTS.md를 읽는다는 점은 Codex·Claude Code와 같은 파일을 공유할 여지가 있다는 뜻으로 볼 수 있다. Gemini CLI에서 Antigravity CLI로 이전 이전 문서가 말하지 않던 탐색 범위와 합치는 방식은 공식 Rules 문서(2026-10-21 기준)가 정한다: 파일의 폴더에서 워크스페이스 루트까지 올라가며 읽고, 모두 합치며, 충돌하면 더 구체적인 디렉터리 규칙이 앞선다. 같은 디렉터리에 AGENTS.md와 GEMINI.md가 둘 다 있을 때 둘 사이의 순서는 이 문서도 말하지 않는다. Antigravity 규칙 문서 → AGENTS.md와 CLAUDE.md 함께 쓰기
  • 스킬 위치: Antigravity CLI 워크스페이스 스킬은 .agents/skills/이고, Claude Code 프로젝트 스킬은 .claude/skills/다. Gemini CLI에서 Antigravity CLI로 이전, Claude Code 스킬 두 원본 모두 상대 도구의 경로를 말하지 않으므로, 한 저장소에서 두 도구를 쓸 때 같은 스킬 폴더를 자동으로 함께 쓴다고 볼 근거는 없다.