차세대 AI 에이전트 터미널, Antigravity CLI (agy) 설치 및 활용 가이드

터미널에서 부리는 AI 에이전트, Antigravity CLI (agy) 설치 및 활용 가이드

Antigravity CLI (agy)란 무엇인가요?

Antigravity CLI(agy)는 구글이 기존의 Gemini CLI를 종료하고 새롭게 선보인 에이전트 우선(Agent-first) 개발 플랫폼인 Antigravity 2.0의 터미널 인터페이스입니다.

개발자가 터미널에서 코딩, 리팩토링, 시스템 구성 같은 복잡한 태스크를 AI 에이전트에게 명령하면, 백그라운드에서 알아서 척척 수행해 주는 아주 강력한 툴이랍니다. 특히 Go 언어로 빌드되어 시동 속도가 엄청나게 빠르고 가벼워서 쾌적한 개발 환경을 제공합니다.

1단계: 운영체제(OS)별 설치하기

터미널이나 명령 프롬프트를 열고 본인의 운영체제에 맞는 명령어를 복사해서 실행해 주세요.

1. 설치 명령어 실행 (약 1~2분 소요)

본인의 OS에 맞는 스크립트를 터미널에 붙여넣어 실행합니다.

macOS / Linux (Bash/Zsh):

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

Windows (PowerShell):

irm https://antigravity.google/cli/install.ps1 | iex

Windows (CMD):

curl -fsSL https://antigravity.google/cli/install.cmd -o install.cmd && install.cmd && del install.cmd

2. 환경 변수(PATH) 확인 (경고 메시지가 뜰 경우)

설치 중 Warning: ... is not present in your active PATH라는 메시지가 뜬다면, 터미널 어디서나 agy 명령어를 쓸 수 있도록 경로를 등록해줘야 합니다.

Linux/macOS 사용자라면 안내에 나오는 대로 아래 명령어를 입력해 주세요. (설치 스크립트가 터미널 창에 알맞은 가이드를 자동으로 띄워줍니다).

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc

3. 설치 완료 검증 (버전 체크)

터미널을 완전히 종료했다가 다시 연 후, 아래 명령어를 입력해 정상적으로 설치되었는지 확인합니다.

agy --version

터미널에 Antigravity CLI 1.0.0 형태의 메시지가 출력되면 성공적으로 설치가 완료된 것입니다!

2단계: 첫 실행 및 로그인(인증)하기

설치가 끝났다면 이제 구글 계정이나 구글 클라우드(GCP) 프로젝트와 연동해야 합니다.

• 서비스 시작: 프로젝트를 진행할 폴더로 이동한 뒤 터미널에 agy를 입력합니다.
• 로그인 인증 링크 클릭: 터미널 창에 구글 로그인 창을 열 수 있는 링크나 일회용 인증 코드(One-time code)가 나타납니다.
• 인증 완료: 브라우저에서 구글 계정 로그인을 마친 뒤 토큰을 터미널에 입력하면 연동이 완료됩니다! (원격 SSH 환경에서도 자동으로 감지되어 로컬 로그인 URL을 제공하므로 안심하셔도 돼요.)

3단계: 핵심 명령어 완벽 숙지하기

Antigravity CLI는 매끄러운 대화형 터미널 UI(TUI)를 제공합니다. 입력창에서 슬래시(/)를 누르면 다양한 특수 명령어를 즉시 활용할 수 있습니다. 가장 자주 쓰는 필수 명령어들을 표로 정리해 드립니다.

명령어	설명	비고
/goal <내용>	에이전트에게 명확한 개발 목적이나 작업 목표를 부여합니다.	가장 핵심적인 시작 명령어
/status	현재 백그라운드에서 실행 중인 에이전트들의 작업 진행 상태를 확인합니다.	비동기 멀티 에이전트 모니터링
/undo	에이전트가 최근에 변경한 코드나 작업을 직전 단계로 되돌립니다.	작업 중 실수했을 때 유용
/logout	현재 저장된 구글 로그인 세션을 안전하게 로그아웃합니다.	계정 전환 시 사용

4단계: 초보자를 위한 5분 실전 워크플로우

백문이 불여일견! 실제로 에이전트에게 작업을 시켜보는 간단한 실전 예시를 따라 해 보세요.

# 1. 테스트용 폴더 만들고 이동하기
mkdir agy-demo && cd agy-demo

# 2. Antigravity CLI 실행하기
agy

이제 agy 프롬프트 입력창이 뜨면 아래처럼 원하는 목표를 자유롭게 적어보세요.

나의 입력 예시:

/goal 파이썬으로 샘플 데이터(sales_raw.csv)를 자동 생성하고, 이 데이터를 읽어서 월별 매출 요약 보고서를 텍스트로 출력해주는 스크립트를 짜줘.

위 명령을 내리면 Antigravity CLI 내부 코어 엔진인 Gemini 3.5 Flash가 여러 하위 에이전트(Sub-agents)를 조율하여 스스로 계획 수립 ➔ 파일 생성 ➔ 코드 작성 ➔ 오류 검증 단계를 한 번에 처리해 줍니다.

대규모 리팩토링이나 다중 서치 작업을 시켜두어도 터미널이 멈추지 않고 백그라운드에서 유기적으로 움직이니, 다른 업무를 편하게 보고 계셔도 괜찮습니다.

💡 초보자를 위한 핵심 꿀팁!
Antigravity CLI는 사용자의 질문뿐만 아니라 현재 폴더의 전체 코드베이스 구조를 완벽히 이해하고 동작합니다. 따라서 질문을 던질 때 this file이나 구체적인 파일명을 직접 언급해주면 훨씬 더 정확하고 깔끔한 코드를 뽑아내 줍니다.