Gemini CLI는 사라졌다. 대신 나온 더 나은 도구.

출처: Dev.to

이 글은 Google I/O Writing Challenge에 제출된 작품입니다.
5월 20일에 터미널을 열고 gemini를 실행했을 때, 사용 중단 알림을 받았습니다.
Google은 I/O 2026에서 Antigravity CLI를 공개했고, 같은 날 Gemini CLI를 종료했습니다.
워크플로에 Gemini CLI를 사용하고 있다면 이미 영향을 받고 있는 것입니다.
아직 한 번도 써보지 않았다면, 그래도 읽어두세요. 이 전환은 필요해지기 전에 이해해 두면 좋은 사고 모델을 제공합니다.

Gemini CLI와 Antigravity CLI의 차이

• Gemini CLI는 프롬프트 인터페이스였습니다. 프롬프트를 보내면 응답을 받는, 그 전부가 모델이었습니다.
• Antigravity CLI는 에이전트 허브입니다. 기본 단위가 프롬프트가 아니라, 서브 작업을 생성하고 도구를 사용하며, 사용자가 다른 일을 하는 동안에도 계속 작동하는 실행 중인 에이전트입니다.

이는 단순히 이름을 바꾼 것이 아니라, 전혀 다른 추상화입니다.

마이그레이션은 깔끔합니다

Gemini CLI에서 중요했던 모든 요소—Skills, Hooks, Subagents—가 그대로 옮겨집니다.
Extensions는 이제 Antigravity Plugins이라고 불리지만 개념은 동일합니다. Gemini CLI 워크플로가 있다면 포팅은 기계적인 작업에 불과합니다.

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

설치 시 API 키를 물어보는 프롬프트가 없습니다. 인증은 에이전트를 처음 호출할 때 이루어집니다. 기존에 ~/.gemini/ 디렉터리가 있다면 CLI가 이를 감지해 Skills를 자동으로 가져옵니다.

agy inspect

아무 작업을 실행하기 전에 먼저 이 명령을 실행하세요:

agy inspect

CLI가 현재 보고 있는 모든 정보를 보여줍니다—로드된 설정 파일, 사용 가능한 Skills(전역 및 워크스페이스), 연결된 Hooks, 설치된 플러그인 등. 에이전트 환경에 대한 git status와 같은 역할을 합니다.

Antigravity CLI v2.0.1

Configuration
  Global config:    ~/.antigravity/config.json
  Workspace config: .agents/config.json (not found)

Skills (global)
  code-review        ~/.antigravity/skills/code-review.md
  commit-message     ~/.antigravity/skills/commit-message.md

Skills (workspace)
  None

Hooks
  None configured

새 프로젝트에서 먼저 실행해 보세요. Skill이 로드되지 않아 디버깅에 시간을 낭비하는 일을 20분 정도 절약할 수 있습니다.

Skill이란?

Skill은 에이전트에게 역할, 도구 접근 권한, 작업 프레이밍을 부여하는 마크다운 파일입니다. 메타데이터가 포함된 저장된 시스템 프롬프트라고 생각하면 됩니다.

워크스페이스 Skill 만들기

mkdir -p .agents/skills

---
name: ux-review
description: Reviews a UI screenshot against Nielsen's heuristics
tools: [read_file]
---

You are a UX analyst. Analyze any UI screenshot against:
- Nielsen's 10 Usability Heuristics
- WCAG 2.1 accessibility guidelines
- Cognitive load principles

Return structured findings: what's working, what's broken, and the specific heuristic being violated.

실행 방법:

agy run --skill ux-review "Review the checkout flow in checkout.png"

.agents/skills/에 있는 Skill은 프로젝트와 함께 이동합니다. ~/.antigravity/skills/에 있는 Skill은 전역으로 사용됩니다. 커뮤니티에서 제공하는 Antigravity Awesome Skills 레포에는 1,400개가 넘는 사전 제작 Skill이 있어, 처음부터 만들 필요가 없습니다.

대담한 의견: 커뮤니티 Skill 라이브러리는 이 생태계에서 가장 과소평가된 자산입니다. 90초면 프로덕션 수준의 코드 리뷰 워크플로를 바로 끌어올 수 있습니다. 대부분의 사람들은 이를 무시하고 프롬프트를 직접 작성하느라 시간을 낭비합니다.

Hooks

Hooks는 라이프사이클 특정 시점에 셸 명령을 실행할 수 있게 해줍니다. 설정은 JSON 형식입니다.

// .agents/config.json
{
  "hooks": {
    "before_tool_call": [
      { "command": "echo '$TOOL_NAME' >> .agents/tool-log.txt" }
    ],
    "on_loop_stop": [
      { "command": "node scripts/notify.js" }
    ]
  }
}

사용 가능한 훅 포인트: before_tool_call, after_model_call, on_loop_stop, on_error.

제가 모든 프로젝트에서 쓰는 패턴은 다음과 같습니다. on_loop_stop은 로그 파일에 요약을 쓰고, before_tool_call은 도구 사용을 기록해 에이전트가 실제로 무엇을 했는지 확인합니다. 전체가 30줄 정도 되는 설정 파일 하나입니다.

실제 업그레이드

Gemini CLI는 동기식이었습니다. 프롬프트를 보내고 에이전트가 끝날 때까지 기다렸다가 다음 작업을 진행했죠.
Antigravity CLI는 비동기 서브 에이전트를 지원합니다—긴 작업을 백그라운드 에이전트에 위임하고, 포그라운드에서는 계속 프롬프트를 입력할 수 있습니다. 같은 세션 안에서 말이죠.

TUI 안에서

> Refactor the auth module to use the new token schema.
  [Dispatching to subagent...]

> While that runs — write a changelog entry for the last 10 commits.

두 작업이 병렬로 진행됩니다. 서브 에이전트가 끝나면 결과를 알려줍니다.

CLI에서

# 백그라운드 에이전트 디스패치
agy dispatch "Run the full test suite and write a summary to test-report.md"

# 현재 활성 서브 에이전트 확인
agy agents list

# 특정 에이전트 출력 가져오기
agy agents output <agent-id>

제가 실제로 테스트한 사례: Next.js 프로젝트에서 약 40개의 파일을 수정하는 타입 리팩터링이 있었습니다.
리팩터링 작업을 백그라운드 서브 에이전트에 맡기고, 포그라운드 에이전트로 PR 설명과 changelog를 동시에 작성했습니다.

리팩터링은 약 4분 만에 끝났고, PR 설명과 changelog는 리팩터링이 완료되기 전에 이미 준비되었습니다. 전체 소요 시간은 순차적으로 진행했을 때 8~10분이던 것이 4분으로 절반 이하로 줄었습니다.

이는 벤치마크가 아니라, 실제로 비동기 에이전트를 사용했을 때 체감되는 효과입니다.

CLI 대신 API 사용하기

import google.generativeai as genai

genai.configure(api_key="YOUR_API_KEY")

agent = genai.create_agent(
    model="gemini-3.5-flash",
    instructions="You are a code reviewer. Review the diff for correctness and security issues.",
    tools=["code_execution"],
)

result = agent.run("Review this diff:\n" + open("changes.diff").read())
print(result.output)

동일한 에이전트 허브, 동일한 Gemini 3.5 Flash 모델, 로컬 설정 없이 바로 사용할 수 있습니다. 에이전트는 Google 인프라의 격리된 Linux 환경에서 실행됩니다.

정리표

대담한 의견: Gemini CLI의 사용 중단은 갑작스러웠습니다. 하지만 Google의 선택은 옳았습니다. 기능 모델이 갈라지는 두 개의 CLI를 유지하는 것보다, 깔끔히 하나로 정리하는 것이 생태계에 더 좋았습니다.

Gemini CLI는 언어 모델을 감싼 터미널 래퍼였지만, Antigravity CLI는 에이전트 허브를 위한 터미널 인터페이스입니다. Skills / Hooks / Plugins 모델은 Claude Code, Cursor, Codex CLI와도 호환됩니다—여기서 만든 Skill은 다른 도구에서도 그대로 사용할 수 있습니다.

전환은 급작스러웠지만, 그 대체물은 확실히 더 나았습니다.

Antigravity CLI: https://antigravity.google
Codelabs: https://codelabs.developers.google.com

Tags: googleio, ai, productivity, devtools