본문으로 건너뛰기

© 2026 Molayo

Zenn헤드라인2026. 05. 21. 10:42

Google의 새로운 TUI Antigravity CLI를 사용해 보았다

요약

Google의 새로운 경량 TUI 도구인 Antigravity CLI(AGY CLI)의 설치 방법과 주요 기능을 정리한 리뷰입니다. Antigravity 2.0의 에이전트 관리 기능과 IDE와의 연동, 그리고 효율적인 터미널 조작을 위한 다양한 슬래시 명령어 및 퀵 팁을 소개합니다.

핵심 포인트

  • Antigravity 2.0은 여러 로컬 에이전트를 관리하고 워크스페이스를 횡단하며 조작할 수 있는 사령탑 역할을 합니다.
  • Google OAuth를 통한 간편한 인증과 사용자 정의 테마 및 에디터 설정을 지원합니다.
  • '@'를 이용한 파일 경로 자동 완성, '!'를 통한 터미널 명령어 직접 실행 등 강력한 TUI 편의 기능을 제공합니다.
  • '/rewind', '/fork'와 같은 명령어를 통해 대화 이력을 되돌리거나 특정 시점부터 대화를 분기할 수 있습니다.

Antigravity의 경량 터미널 사용자 인터페이스(TUI)인 Antigravity CLI (AGY CLI)를 사용해 보았기에, 셋업 과정과 기존 Gemini CLI와의 코드 생성 비교를 정리해 보았습니다.

1. 셋업

먼저 문서(Google Antigravity Documentation)를 보면서 설치를 진행합니다.

Mac의 경우, 다음의 curl 명령어로 설치할 수 있습니다.

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

하지만 Antigravity 다운로드 사이트를 보면, CLI를 사용하기 전에 Antigravity 또는 Antigravity IDE 측에서 인증을 마쳐두어야 하는 것 같습니다.

여기서 조금 혼란스러웠던 점은 툴들의 버전과 이름의 관계입니다.

Antigravity 2.0: 여러 로컬 에이전트(Agent)를 병행하여 관리하기 위한 사령탑. 대화를 프로젝트별로 묶고, 여러 워크스페이스(Workspace)를 횡단하여 조작하며, 예약 메시지 기능으로 루틴 작업을 자동화할 수 있습니다.
Antigravity IDE: 다기능 에이전트형 IDE. 에이전트 매니저와 아티팩트(Artifact) 기능을 갖추고 있으며, 코드베이스를 깊이 있게 이해합니다.

v1.0에서의 업데이트라고 생각하고 v2.0을 설치하면, Antigravity IDE가 아니라 에이전트 관리 데스크톱 앱이 설치되어 버립니다.

이번에는 기왕 하는 김에 Antigravity IDE를 설치하여 인증을 진행합니다.

agy 명령어를 실행하면 AGY CLI가 기동합니다.

기동하면 테마 설정 등이 진행됩니다.

이번에는 자신의 Google 계정으로 작동시켜 보려고 하므로, Google OAuth를 선택합니다.

링크가 표시되므로, 그것을 클릭하여 인증을 진행합니다.

그 후 테마 설정과 데이터 제공 이용 약관에 응답하면 완료됩니다.

설정 파일은 ~/.gemini/antigravity-cli/settings.json에 생성됩니다.

AGY CLI 기동 중에 /config 또는 /settings를 입력하면 설정 화면이 열리므로, 그곳에서 설정할 수 있습니다.

저는 다음과 같은 설정으로 사용하고 있습니다.

{
"colorScheme": "tokyo night",
"editor": "vim",
...

Gemini CLI와의 호환성을 유지하기 위해 기동 시 마이그레이션(Migration) 옵션이 표시됩니다.

표시되지 않는 분은 agy plugin import gemini 명령어를 실행해 주세요.

2. 기억해 두면 편리한 조작 & 슬래시 명령어

퀵 팁(Quick Tips)과 슬래시 명령어(Slash Commands)를 일본어 번역과 함께 표로 정리했습니다.

퀵 팁

액션/기능힌트/명령어
파일 경로 자동 완성@를 입력하면 경로 후보가 표시됩니다
프롬프트(Prompt) 삭제esc를 두 번 누르면 프롬프트 박스가 비워집니다 (스트리밍 중이 아닐 경우)
터미널 명령어 실행프롬프트 맨 앞에 !를 붙이면 터미널 명령어를 직접 실행할 수 있습니다
도움말 표시?를 입력하면 도움말 및 슬래시 명령어 목록이 표시됩니다
툴 호출 출력 감소/config에서 verbosity(상세도)를 low로 설정하면, 대량의 툴 호출로 인한 출력을 최소화할 수 있습니다
권한 관리/config 또는 /permissions를 통해 권한을 제어할 수 있습니다
대화 되돌리기/rewind 또는 /undo를 사용하면 대화 이력을 되돌릴 수 있습니다
대화 분기/fork를 사용하면 다른 워크스페이스를 열어, 과거의 시점부터 대화를 가지치기할 수 있습니다
대화 초기화/clear를 사용하면 프롬프트가 삭제되고 새로운 대화 세션을 시작할 수 있습니다
대화 재개/resume을 사용하면 과거의 대화 로그 목록을 표시하고 재개할 수 있습니다
자동 저장 및 재개CLI를 종료하면 해당 세션을 재개하기 위해 필요한 명령어가 자동으로 표시됩니다

슬래시 명령어 목록

AGY CLI에서는 프롬프트 박스에 직접 입력하는 다양한 슬래시 명령어 (Slash Commands)를 사용하여 대화 관리, 설정 변경, 에이전트 기능 확인을 수행할 수 있습니다.

명령어카테고리용도
/resume (alias /switch)대화대화 피커 (Conversation Picker)를 열어 세션을 재개하거나 전환합니다.
...

여기에 목록에는 없지만, /fast 명령어를 사용하면 에이전트가 태스크를 직접 실행하므로 더 빠르게 태스크를 수행할 수 있습니다.

/model 설정 화면을 보면 다음과 같은 모델 선택지가 나열되어 있었습니다.

  • Gemini 3.5 Flash (High)
  • Gemini 3.5 Flash (Medium)
  • Gemini 3.1 Pro (High)
  • Gemini 3.1 Pro (Low)
  • Claude Sonnet 4.6 (Thinking)
  • Claude Opus 4.6 (Thinking)
  • GPT-OSS 120B (Medium)

기본값은 Gemini 3.5 Flash (High)로 설정되어 있었습니다.

지금까지 모델명에 preview가 붙어 있었는데, 더 이상 사용되지 않는군요.

Gemini 이외의 모델 라인업은 Antigravity v1.0과 동일합니다.

3. 실력 검증: Gemini-CLI vs Antigravity CLI

이번에는 이전을 하는 것이라 선택의 여지는 없지만, 기왕 둘 다 사용할 수 있으니 비교를 해보겠습니다.

주제는 "Three.js를 사용하여, 단 하나의 HTML 파일로 완결되는 아름다운 3D 불꽃놀이 애니메이션을 만들어 주세요."라는 프롬프트 하나로, Plan 모드를 사용하지 않고 index.html을 생성하게 합니다.

사용할 모델은 Gemini CLI는 gemini-3.1-pro-preview, AGY CLI는 Gemini 3.1 Pro (High)를 선택했습니다.

기왕 하는 김에 /fast 명령어를 사용하여 에이전트가 태스크를 직접 실행하도록 해보겠습니다.

참고로 저 자신도 Three.js의 전문가가 아니므로, 코멘트는 참고용으로만 봐주세요.

Gemini CLI의 결과

생성 결과

Gemini CLIの生成画面

생성된 코드

코드

<!DOCTYPE html>
<html lang="ja">
<head>
...

생성에 걸린 시간: 4m11s

OrbitControls를 사용하고 있어서, 움직이거나 줌(Zoom)이 가능합니다.

전체적으로 표현이 단조로운 점은 아쉽지만, 코드도 깔끔하다고 생각합니다.

AGY CLI의 결과

생성 결과

AGY CLIの生成画面

코드

<!DOCTYPE html>
<html lang="ja">
<head>
...

생성에 걸린 시간: 2m20s

PointsMaterial에 더해 UnrealBloomPass를 사용하고 있어서, 불꽃놀이 표현이 더욱 섬세합니다.

또한, setPixelRatio 설정을 통해 고해상도(High DPI) 환경에서도 다루기 쉽게 되어 있습니다.

사용 중인 모듈이 다소 오래된 점과 복사량이 많다는 점이 걸림돌이지만, 그려진 결과물은 아름답습니다.

요약

이름이 바뀐 것뿐만 아니라 구현 언어가 TS (TypeScript)에서 Go로 바뀌었으며, 명령어들도 변경되었다는 것을 알 수 있었습니다.

개인적으로는 Gemini CLI는 오픈 소스였지만, AGY CLI의 코드가 현재 비공개 상태라는 점이 아쉽습니다.

이제 막 사용하기 시작해서 서브 에이전트(Sub-agent)를 만들거나, Skills로 커스터마이징하는 등의 작업은 해보지 못했으므로 앞으로도 계속 시도해 보려고 합니다.

여러분도 Gemini CLI로부터의 이전을 계기로 꼭 AGY CLI를 사용해 보세요.

Discussion

AI 자동 생성 콘텐츠

본 콘텐츠는 Zenn AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.

원문 바로가기
0

댓글

0