notes
CLI 설정 및 설치 / 기본 설명
CLI 도구의 설치·초기 설정과 기본 사용 흐름을 정리한 메모.
차이
- 2.0: IDE가 아님. “에이전트 관제실”에 가깝습니다. (공식 소개)
- CLI: Gemini CLI 후속. 터미널에서 같은 하네스로 에이전트 실행.
- IDE: VS Code 계열에서 코드를 보며 에이전트와 같이 작업.
CLI 쓸 때 2.0·IDE를 같이 쓰는 이유
필수는 아닙니다. 역할이 겹치지 않아서 같이 쓰는 게 효율적입니다.
- CLI → 큰 리팩터·테스트·원격/백그라운드 실행
- IDE → 결과 diff를 눈으로 보고 accept/reject, 직접 손보기
- 2.0 → 여러 에이전트·여러 레포를 한 화면에서 돌리고 감시
즉 CLI만으로는 “실행”은 되지만, 시각 리뷰·다중 작업 관제는 IDE/2.0이 담당합니다. Google도 2.0을 선호 IDE와 dual-wield 하라고 권합니다.
선택만 하면
- 코드 직접 고치며 확인 → IDE
- 터미널/SSH/자동화 → CLI
- 여러 에이전트 동시 운영 → 2.0
셋 다 같은 플러그인·스킬·하네스를 쓰므로, 작업 단계마다 바꿔 쓰면 됩니다.
왜 “2.0 + IDE 먼저 → CLI”인가
세 개는 전부 같은 에이전트 하네스를 쓰지만, 설치·역할이 다릅니다.
- Antigravity 2.0 — 에이전트 관제용 데스크톱 앱 (IDE 아님)
- Antigravity IDE — 코드 편집용 데스크톱 앱
- Antigravity CLI (
agy) — 터미널용. 2.0과 설정·권한·대화를 공유
그래서 문서/가이드가 보통 이렇게 말합니다.
- 먼저 데스크톱(2.0·IDE)으로 Google 로그인·프로젝트/권한 잡기
- 그다음 CLI 설치 → 같은 계정·설정을 물려받아
agy로 터미널에서 이어쓰기
CLI만 먼저 깔아도 동작은 하지만, 인증·설정·대화 이어보기는 2.0과 맞춰 두는 쪽이 덜 꼬입니다.
공식도 CLI를 “2.0의 터미널 대안”으로 설명합니다. (CLI 소개, Overview)
1단계: Antigravity 2.0 + IDE 설치
다운로드: antigravity.google (Download)
처음 쓰는 경우
- 사이트에서 macOS용 설치
- 앱 실행 → Google 계정 로그인
- 업데이트/온보딩에서 IDE도 유지할지 물어보면, 개발이면 Keep IDE 권장
이미 Antigravity IDE가 있는 경우
- IDE가 업데이트되면 2.0으로 전환/추가되고, IDE 유지 여부를 묻습니다.
- Dock 아이콘 구분 (공식):
- 2.0 — 흰 배경 로고
- IDE — 검정 그리드 위 로고
둘 다 깔아 두는 게 정상입니다. (2.0 = 관제, IDE = 편집)
설치후 실행시에는 커서나 vs코드 ,윈드서프 같은 ai 에디터 llm을 연동가능
2단계: CLI 설치 (macOS)
터미널에서:
macOS | Linux
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설치 후:
# PATH에 ~/.local/bin 이 없으면 (새 터미널에서도 안 되면)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
agy --version
agy첫 실행 때 로그인/인증이 나오면, 데스크톱과 같은 Google 계정으로 맞추면 설정이 공유됩니다.
공식 설치 안내: github.com/google-antigravity/antigravity-cli
설치 후 역할만 기억
체크리스트
- antigravity.google에서 2.0 설치·로그인
- 온보딩에서 IDE 유지
install.sh로 CLI 설치 →agy --version확인- 같은 Google 계정으로 CLI 인증