Gemini CLI → Antigravity CLI への移行

Googleは 2026年5月19日に、 Gemini CLIから Antigravity CLIへの移行を発表しました。有料のエンタープライズ顧客については変更ありません。Google AI Pro、Ultra、または個人向けの無料Gemini Code Assistアカウントを利用しているすべてのユーザーにとって、Gemini CLIは 2026年6月18日にリクエストの提供を停止します。これは、一晩で実行できる移行プランであり、重要なワークフローが破損した場合のロールバック手順も含まれています。

1. 発表内容

同日、Google の 2 つのチャネルがこの移行について公開しました。 Google Developers Blog がタイムラインを提示し、 X の @geminicli アカウント が個人ティアのユーザー向けに 30 日間の移行期間を確約し、エンタープライズ顧客については明示的に対応不要として対象から除外しました。

Google DeepMind は別の公式アカウントから、より大きな展望を示しました — CLI は単独の製品ではなく、3 つのインターフェースからなる開発者向けオファリングの一部であるということです。

公式の 移行ドキュメント （場所： antigravity.google/docs/gcli-migration ）は、ファイルごとのマッピングにおける信頼できる情報源（source of truth）です。以下の手順はドキュメントの順序に従っており、ドキュメントでは明文化されていない注意点（gotchas）についても補足しています。

2. 要約 (TL;DR)

• 期限： 2026年6月18日（個人ティア）
• 対象： Google AI Pro、Google AI Ultra、無料版 Gemini Code Assist
• 影響を受けないもの: Code Assist Standard / Enterprise、有料の Gemini API キー
• 後継ツール: Antigravity CLI (バイナリ: agy)
• ワンコマンドでの移行: agy plugin import gemini
• 手動での移動が必要なもの: .gemini/skills/ → .agents/skills/、および MCP 設定の移行先: mcp_config.json
• フィールド名の変更: リモート MCP url → serverUrl
• コンテキストファイル: GEMINI.md および AGENTS.md 変更なしで動作し続けます
• 並列インストール: 安全 — gemini と agy が共存
• このガイドの読了時間: 14分、作業時間: 約45分

3. タイムライン

4. 対象となるユーザー

読み進める前に、以下のクイックチェックを行ってください：

• 個人の Google アカウントで Gemini CLI にログインしている。 対象となります — これは無料/コンシューマー向けのフローです。
• Google AI Pro または Google AI Ultra の料金を支払っている。 対象となります。Antigravity CLI は同じサブスクリプションを使用します。
• 個人向けの Gemini Code Assist（無料枠）を使用している。 対象となります。Gemini CLI と Code Assist IDE 拡張機能の両方が6月18日に停止します。
• 有料の Gemini API キーで Gemini CLI の認証を行っている。 対象では ありません 。有料 API キーのユーザーについては、Gemini CLI は引き続き利用可能です。
• 所属組織が Gemini Code Assist Standard または Enterprise ライセンスを保有している。 対象では ありません 。Enterprise 向けの CLI アクセスに変更はありません。

5. Enterprise 向けの例外規定

Google Developers Blog によると： “組織が Gemini Code Assist Standard または Enterprise ライセンスを通じて Gemini CLI や IDE 拡張機能を使用している場合、あるいは Google Cloud を通じて Gemini Code Assist for GitHub を使用している場合、アクセス権に変更はありません。引き続き Gemini CLI および Gemini Code Assist をサポートし、最新の Gemini モデルへのアクセスやその他のアップデートを提供します。”

具体的には、企業ユーザーには以下の3つの選択肢があります：

• Standard / Enterprise ライセンスで Gemini CLI を使い続ける — 移行は不要です。
• 有料の API キーで Gemini CLI を使い続ける — 移行は不要です。
• GCP プロジェクトの認証情報を使用して、Antigravity CLI を併用する。GCP プロジェクトの連携に関する詳細は、公式のエンタープライズ向けページを参照してください。

もしあなたが他の誰かのためにこれを読んでいるエンタープライズ管理者なら、重要なポイントは以下の通りです。 パイロット運用を計画してください。組織全体を慌てて移行（panic-migrate）させる必要はありません。 期限が適用されるのはコンシューマー（個人）ティアのみです。

6. 事前チェックリスト

移行を開始する前に、以下を確認してください：

• お使いのマシンに Go で配布されたバイナリをインストールできること（agy） — curl、irm、または管理者シェルへのアクセス権があること。
• 現在 Gemini CLI で使用している Google アカウントを把握していること（移行後も同じアカウントが引き継がれます）。
• インストール済みの Gemini CLI 拡張機能の一覧を表示できること（gemini extension list）。
• お使いの ~/.gemini/ ディレクトリがそのまま残っていること（ここにはグローバルなルールやスキルが保存されています）。
• カスタムの .gemini/ フォルダを持つワークスペースプロジェクトが識別されました — ワークスペーススコープのスキルについては、それぞれ手動で移動する必要があります。
• CIやcronからGemini CLIの呼び出しをスクリプト化している場合は、バイナリ名（gemini → agy）と認証フローを切り替えるための移行計画（フラグデイ・プラン）を確認してください。

7. ステップ 1: Antigravity CLIのインストール

公式READMEに記載されている、プラットフォームごとのインストールコマンド：

# 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

インストール後、以下を確認してください：

agy --version
# expected: a version string is printed

バイナリ名は agyであり、 antigravityではありません。CLI呼び出しをスクリプト化している場合は、ここをリネームしてください。Gemini CLIの geminiバイナリはそのまま残り、両方が共存します。

8. ステップ 2: 認証

初回実行時に認証フローが開始されます。2つのバリエーションがあります：

• ローカルターミナル。 実行 agy。デフォルトのブラウザが開きます。Gemini CLIで使用したのと同じGoogleアカウントでサインインしてください。トークンはシステムのキーリングに保存されます。
• リモート / SSH。 実行 agy。CLIがSSHセッションを検出し、認証URLを表示します。ローカルマシンでそのURLを開き、OAuthフローを完了させると、SSHセッションがトークンを取得します。これは初期のGemini CLIにおける大きな課題でしたが、現在は第一級の機能としてサポートされています。
• エンタープライズ。 オンボーディング中にGCPプロジェクトを接続できます。その後の呼び出しはそのプロジェクトに対して課金されます。詳細は公式のエンタープライズドキュメントに記載されています。

9. ステップ 3: プラグインのインポート

On first launch, Antigravity CLI prompts to migrate Gemini CLI extensions to Antigravity plugins. If you skip the prompt or are installing on a fresh machine, run the import explicitly:

agy plugin import gemini

公式の移行ドキュメントからのサンプル出力です。マルチコンポーネント拡張機能の移行プロセスを説明しています。

[ok]    conductor
          - skills      : skipped (not found)
          - agents      : skipped (not found)
          ✔ commands    : 6 processed (converted to skills)
          - mcpServers  : skipped (not found)
          - hooks       : skipped (not found)
[ok]    google-workspace
          ✔ skills      : 6 processed
          - agents      : skipped (not found)
          ✔ commands    : 4 processed (converted to skills)
          ✔ mcpServers  : 1 processed
          - hooks       : skipped (not found)

10. ステップ 4: MCP 設定の移動

Gemini CLI は MCP サーバーの設定を以下の中にインラインで保存していました： settings.json。 Antigravity CLI は別のファイルを使用します。これらを移動してください：

また、JSON自体の中で1つのフィールド名を変更する必要があります：

// Gemini CLI (settings.json)
{
  "mcpServers": {
    "my-remote-mcp": {
      "url": "https://example.com/mcp"   // or the deprecated "httpUrl"
    }
  }
}

// Antigravity CLI (mcp_config.json)
{
  "my-remote-mcp": {
    "serverUrl": "https://example.com/mcp"
  }
}

リモートの MCP サーバーは、 url をリネームせずにコピーすると、サイレントに失敗します。command と args を持つローカルの MCP サーバーエントリは、リネームの必要はありません。MCP 設定の背景については、こちらの MCP チュートリアルを参照してください。

11. ステップ 5: ワークスペーススキルの移動

以下の場所にあるグローバルスキル ~/.gemini/skills/ は自動的に読み込まれるため、対応は不要です。以下の場所にあるワークスペーススキル .gemini/skills/ は .agents/skills/へ移動する必要があります：

# Per project, from the workspace root:
mkdir -p .agents
git mv .gemini/skills .agents/skills
# Or, if not in git:
mv .gemini/skills .agents/skills

ワークスペースにすでに .agents/skills/ フォルダが存在する場合（Gemini CLI のドキュメントで許容されていた、2つの場所に存在するケース）、そちらを保持し、 .gemini/skills/ のコピーを削除してください。作成パターンについては、こちらの Antigravity スキルセットアップガイド.

12. ステップ 6: フックとコンテキストの検証

移行を完了とする前に、確認すべき2つの事項があります：

• コンテキストファイルが読み込まれること。 GEMINI.md および AGENTS.md （ワークスペース内）、さらに ~/.gemini/GEMINI.md （グローバル）が、すべて変更なく動作し続けること。セッションを開始し、ファイル内の既知のルールを復唱するようエージェントに依頼してください。
• JSON フックが実行されること。 Antigravity 2.0 または Gemini CLI 向けに JSON フックを作成した場合、それらは Antigravity CLI でも同じライフサイクルのタイミングで適用されます。ファイルを編集するか、サンプルのツール呼び出しを実行して、既存のフックが実際に実行されることを確認してください。

ルールのパターンについては、当社の ルールの例 および GEMINI.md システムプロンプトガイドを参照してください。

13. ステップ 7: 実タスクによる検証

決してスキップしてはいけないステップです。昨日 Gemini CLI で行ったタスク — リファクタリング、リサーチ、複数ファイルの編集など — を1つ選び、同じリポジトリで Antigravity CLI を使用して実行してください。比較してください：

• エージェントは同じステップで同じツールに到達しましたか？
• スラッシュコマンドは適切な場所で実行されましたか？
• MCPサーバーの呼び出しは実行されましたか？（サイレントな serverUrl 失敗に注意してください。）
• コンテキストファイル（GEMINI.md、 AGENTS.md）は、以前と同様に動作に影響を与えましたか？
• フックは期待通りのライフサイクルのタイミングで呼び出されましたか？

代表的なタスクに20〜30分費やすことで、必要な判断材料の90%が得られます。すべてが再現されれば完了です。もし一つでも問題が発生した場合は、それを報告し、修正されるまでそのワークフローについては Gemini CLI にフォールバックしてください。

14. ロールバックプラン

Antigravity CLI と Gemini CLI は同じマシン上に共存できます。これらは個別のバイナリ（agy と gemini）であり、設定ツリーも分かれています（~/.gemini/antigravity-cli/ の横に ~/.gemini/）、および個別の認証フロー。2026年6月18日までは、個別のワークフローに対するロールバックは単純に以下の通りです： 引き続き gemini をそのタスクで実行し続けることです。

6月18日以降、ロールバックの選択肢は以下に絞られます：

• エンタープライズライセンス（Gemini Code Assist Standard / Enterprise）にアップグレードする。
• 有料の Gemini API キーに切り替える。
• 影響を受けるワークフローに対して、CLIの代わりに Antigravity 2.0（GUI）を使用する。
• 完全に別のエージェントCLIを使用する。当社の 代替案のまとめ で最新の状況をご確認ください。

15. 変更点の概要

16. FAQ

17. 結論

今日もし1つだけ実行するなら、Gemini CLI を最も頻繁に使用していたマシンに Antigravity CLI をインストールしてください。それ以外のステップは、そこから先もっと簡単に進められます。

出典

• Google Developers Blog — 重要なお知らせ：Gemini CLI から Antigravity CLI への移行
• Xの @geminicli — 移行のアナウンス
• Antigravity CLI — Gemini CLI からの移行（公式ドキュメント）
• Google Antigravity CLI のご紹介 — antigravity.google
• Google Antigravity 2.0 のご紹介 — antigravity.google
• Antigravity CLI 概要 — 公式ドキュメント
• google-antigravity/antigravity-cli — GitHub リポジトリ