Gemini CLIからAntigravity CLIへの移行ガイド

2026年5月19日、GoogleはFree、Pro、Ultraのすべてのプランで、旧Gemini CLIを6月18日に終了すると発表しました。このガイドの公開から2週間後には、geminiコマンドはリクエストを処理しなくなります。Googleのツールを使い続けるには、agyコマンドを使ってGemini CLIからAntigravity CLIへ移行するしかありません。agyはGoで作られており、起動は数十倍速くなっています。

CIスクリプト、夜間のcronジョブ、Gemini Code Assist IDE拡張機能など、Gemini CLI上で動いているものがあれば、このガイドでは何も壊さずに一晩で移行する方法を説明します。

2026年6月18日に、具体的に何が使えなくなるのか？#

これは「プロジェクトの完全終了」ではなく、最も人気のある3つのプランを打ち切るものです。影響を受けるプランは次のとおりです。

Google Developers Blogの公式発表より：

ほとんどの個人開発者と同じようにFreeプランを使っていて、「でも有料アカウントを持っている」と考えているなら、APIキーの請求方法を正確に確認してください。AI ProはCloud請求ではなく、個人向けGoogle AIサブスクリプションであり、こちらは無効化されます。有料プロジェクトを使ったCloud請求は無効化されません。

GoogleはなぜGemini CLIを終了するのか？#

旧版のgeminiは、Node.jsの起動待ちが必要なため「数百ミリ秒」で起動していました。新しいagyは単一の静的Goバイナリとして構築され、「数ミリ秒」で起動します。1回の実行でCLIを何百回も呼び出すCIやスクリプトでは、この差は大きな意味を持ちます。

速度とその理由について、Googleは次のように説明しています。

Gemini CLIの主な機能はすべて移行されています。

• Agent Skills — .gemini/skills/フォルダーは.agents/skills/に移りました。
• Hooks — 同じイベント（PreToolUse、PostToolUseなど）に対応し、構文もほとんど変わっていません。
• Subagents — 以前と同じように動作し、設定も自動で移行されます。
• Extensions — Antigravityプラグインに名称が変わり、1つのコマンドでインポートできます。

シームレスに移行できなかったものは、MCPサーバーと、.gemini/config.jsonに直接アクセスする古いスクリプトです。GitHubのディスカッションによると、MCP設定が壊れ、手作業で書き直す必要があると報告しているユーザーもいます。これについては後述の専用セクションで説明します。

GoogleはGemini CLIのオープンソースプロジェクトを終了しません。

つまり、フォークして自分のGemini APIキーで使い続けることはできます。ただし、これはCloud請求を使う有料の構成になります。無料のCode Assistの利用形態は終了します。

Antigravity CLIのインストール方法：macOS、Linux、Windows向けコマンド#

始める前に簡単に確認してください。どのプランを利用していますか？6月18日の期限がない有料Cloudプロジェクトを使っているなら、移行は役立ちますが急ぐ必要はありません。Free/Pro/Ultraを利用していてCLI上で動いているものがあれば、各プランがまだ有効なうちに切り替えて、同じタスクで動作を比較しましょう。

macOSとLinux

curlを使う1行コマンド：

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

スクリプトはプラットフォームを検出し、agyバイナリをダウンロードしてチェックサムを確認し、~/.local/binに配置します。このフォルダーがPATHにない場合は、追加してください。

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

バイナリが見つかることを確認します。

which agy
agy --version

Windows（PowerShell）

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

バイナリはC:\Users\[your_name]\AppData\Local\agy\binにインストールされます。インストーラーがPATHを自動更新しますが、変数を再読み込みするため、新しいPowerShellウィンドウを開いてください。

Windows（CMD）

企業のポリシーでPowerShellがブロックされている場合：

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

インストールを確認する

どのOSでも、インストール後に次を実行します。

agy doctor

このコマンドは、バイナリのバージョン、設定ファイルの有無、認証、antigravity.googleへのネットワークアクセスを確認します。Googleに接続できない場合、問題は地域またはプロキシにあります。

認証

引数なしで初めてagyを実行すると、セットアップウィザードが起動します。

1. インターフェースのテーマを選択します。
2. 認証方法を選択します。個人アカウント用のGoogle OAuth、またはAPIキーです。
3. 必要に応じて、.gemini/の設定をその場でインポートします。

OAuthを選択するとブラウザーが開き、accounts.google.comにリダイレクトされます。データ共有への同意が必要です。その後、CLIを使えるようになります。

.geminiから.agentsへ設定とプラグインを移行する方法#

手順は次のとおりです。

1. agy plugin import gemini

   このコマンドはどのフォルダーからでも実行できます。グローバルプラグインを~/.gemini/から~/.agents/へ移行します。ワークスペースのプラグイン（プロジェクト内にあるもの）を移行するには、プロジェクトフォルダー内でコマンドを実行してください。

2. mv .gemini/skills/ .agents/skills/

   フォルダー名を手動で変更してskillsを移動します。内部のファイル形式は同じなので、Markdownを書き直す必要はありません。

3. agy inspect

   有効なプラグイン、skills、hooks、subagentsを表示します。Gemini CLIで使っていた一覧と比較し、漏れがないことを確認してください。

4. agy config --edit

   既定のエディター（$EDITOR）で設定を開きます。自動で取り込まれなかったものがあれば、手動で編集してください。

5. agy doctor

   最終確認では、バイナリ、認証、プラグイン、ネットワークを確認します。4項目すべてが緑色なら、設定の移行は完了です。

見落としがあった場合に備えて、古い.gemini/フォルダーは1か月ほどバックアップとして残しておくとよいでしょう。Antigravityを1週間使い、すべて揃っていることを確認したら、削除できます。

AGENTS.mdをすべてのAIツールで使える共通設定として利用している場合は、変更する必要はありません。Antigravity CLIはClaude CodeやCodexと同じフォルダーからAGENTS.mdを読み込みます。

変更が必要な環境変数は？#

置き換え一覧：

シークレットを渡しているGitHub Actionsがある場合は、Settings -> Secrets -> Actionsを開き、キー名を変更してください。値そのものは変わりません（移行中にGoogle APIキーは変更されていません）。

GEMINI_を含む可能性のある場所をすべて確認します。

# プロジェクト全体の記述を検索
grep -rn "GEMINI_" . --include="*.yml" --include="*.yaml" --include="*.sh" --include=".env*" 2>/dev/null

# dotfiles内
grep -nE "GEMINI_" ~/.zshrc ~/.bashrc ~/.bash_profile ~/.config/fish/config.fish 2>/dev/null

置き換え後、ターミナルを再起動し、秘密情報を表示せずに変数の有無を確認します。シェルのトレースを有効にせず、値をログへコピーしないでください。変数があるだけでは認証の証明にならないため、agy doctorで別途調べます。

if [ -n "${AV_API_KEY:-}" ]; then
    printf 'AV_API_KEY is set\n'
else
    printf 'AV_API_KEY is missing or empty\n'
fi
agy doctor        # should show “authorized”

移行時によく起こる問題とその解決方法#

初期に起こる問題のチェックリスト：

1. MCPサーバー。 .gemini/config.jsonでmcp_serversを使っていた場合、agy plugin import geminiの後に引き継がれていない可能性があります。agy inspectで確認してください。mcpセクションが空、またはエラーが表示される場合は、agy config --editで手動で書き直します。形式についてはAntigravityの公式ドキュメントにあるMCPセクションを参照してください。

2. カスタムhooks。 .gemini/hooks/に$GEMINI_API_KEYを読み込むbashスクリプトがあった場合、動作しなくなります。次のコマンドで該当箇所を探します。bash

   grep -rn "GEMINI_" .agents/hooks/ 2>/dev/null
   

   変数を置き換えてください。

3. CI/CD。 GitHub ActionsやGitLab CIでgeminiコマンドを使っている手順をagyに変更します。インストーラーでのバイナリ名が異なる場合があるため、$CLI_CMD変数を使った抽象化を作成してください。

4. IDE拡張機能。 VS Code用Gemini Code Assist拡張機能はCLIとともに無効化されます。代替はAntigravity IDE（別のVS Codeフォーク）、または他のAIエディターで使うAGENTS.mdです。

5. @[file]の読み込み。 初期のAntigravity CLIビルドでは、@src/file.tsコマンドでファイルをコンテキストに読み込む際にバグがありました。最新版のagy updateに更新してください。

重大な問題が起こり、1時間以内に解決できない場合、Freeプラン向けの一時的な方法として、6月18日までGemini CLIを使い続けながら、別のリポジトリブランチで移行を準備できます。期限は14日です。

6月18日以降もGoogleのツールを使う価値はあるか？#

Antigravity 2.0は、主要ツール（Claude CodeまたはCodex）が適さない場合の予備として検討できます。得意なことと苦手なことの詳しい説明は、Google Antigravity 2.0のガイドを参照してください。

状況ごとの対応を簡単にまとめます。

15分でできる移行チェックリスト#

1. Antigravity CLIをインストールする

   curl -fsSL https://antigravity.google/cli/install.sh | bash（macOS/Linux）、またはirm https://antigravity.google/cli/install.ps1 | iex（Windows PowerShell）。

2. agyを起動して認証する

   引数なしでagyを実行します。OAuthまたはAPIキーを選択します。

3. .geminiからプラグインをインポートする

   agy plugin import geminiを実行すると、拡張機能がグローバルに移行されます。ワークスペースのプラグインを移行するには、プロジェクトフォルダー内でもう一度実行してください。

4. skillsを移動する

   mv .gemini/skills/ .agents/skills/を実行します。ファイルの内容はそのままです。

5. 環境変数を置き換える

   ~/.zshrc/~/.bashrcと.envファイル内で、GEMINI_API_KEY → AV_API_KEY、GEMINI_PROJECT_ID → AV_PROJECT_ID、GEMINI_REGION → AV_REGIONに置き換えます。ターミナルを再起動してください。

6. インストールを確認する

   agy doctorを実行します。4項目（バイナリ、認証、プラグイン、ネットワーク）がすべて緑色になっていることを確認してください。

7. テストタスクを実行する

   agy "write a README for the project in the current folder"を実行し、Gemini CLIで生成した結果と同じような内容になるか確認します。

8. GitHub Actions / GitLab CIを更新する

   コマンド名とシークレットをGEMINI_*からAV_*に変更します。

9. .gemini/をバックアップとして残す

   すべて動くことを確認してから1〜2週間後に削除できます。

最後に、6月18日は「すべてのプロジェクトが停止する」という意味ではありません。無効化されるのは無料での利用経路です。有料Cloud APIアクセスは引き続き利用でき、Gemini CLIのリポジトリも残り、フォークも可能です。Freeプランを使っていた場合は6月18日までに決める必要があります。そうしなければ、次にgemini "something"を実行した際に認証エラーが返されます。