クイックリファレンス

Google Antigravity CLI (agy) コマンド&設定早見表

Googleのターミナル向けAIコーディングエージェント Antigravity CLI (agy) のコンパクトリファレンス:起動フラグとサブコマンド、TUIスラッシュコマンド・ショートカット、.agents/ と mcp_config.json の設定階層、Gemini CLI からの移行チェックリストを解説。

· 公開日

Antigravity CLI (agy) は、Antigravity 2.0 プラットフォームにおける Google 製の軽量な Go ベース・ターミナルネイティブコーディングエージェントです。並列サブエージェント実行、Git worktree 分離、Agent Skills、プラグイン、MCP 連携を前提に構築されており、コンシューマー版 Gemini CLI の後継となります。

この早見表では agy CLI のフラグとサブコマンド、対話型スラッシュコマンド、キーバインド、.agents/ および mcp_config.json の設定、Gemini CLI からの移行手順をまとめています。

🔗 関連チートシート: ターミナルAIコーディングCLI比較早見表 · Claude Code CLI 早見表 · OpenAI Codex CLI 早見表 · AI Agent スキル設計アーキテクチャ早見表


1. インストール・サブコマンド・起動フラグ

1.1 インストールと起動

# Antigravity CLI をインストール
curl -fsSL https://antigravity.google/cli/install.sh | bash

# 対話型 TUI を起動(初回起動時は画面の認証案内に従ってください)
agy

1.2 主要サブコマンドと起動フラグ

コマンド / フラグ 説明 使用例
agy アクティブなワークスペースで対話型 TUI を起動 agy
agy -p "<prompt>" 非対話型(ヘッドレス)実行。結果を stdout に出力して終了 agy -p "Summarize the last 5 commits"
agy -i "<prompt>" 初期プロンプトをセットした状態で対話セッションを起動 agy -i "Refactor auth middleware under src/auth"
agy -c, --continue 直近の会話セッションを再開 agy -c
agy --conversation <id> ID を指定して過去の特定セッションを読み込む agy --conversation 42a506e6-...
--mode <mode> 実行権限モードを設定:
default · accept-edits · auto(サンドボックス内自動承認) · plan
agy --mode accept-edits
--model <model> このセッションで使用するモデルを上書き指定 agy --model gemini-3.8-flash
--effort <level> 推論の effort レベルを設定(low 〜 max、モデル依存) agy --effort high
--agent <agent> 起動時にカスタムエージェントプロファイルをアタッチ agy --agent reviewer
--add-dir <path> ワークスペースコンテキストへのアクセス権限を追加ディレクトリへ付与(複数指定可) agy --add-dir ../shared-types
agy models / agy agents 利用可能なモデル一覧または設定済みカスタムエージェントを表示 agy models
agy plugin <subcmd> プラグイン管理:install · list · validate --strict · import gemini agy plugin validate --strict ./my-plugin

2. 対話型 TUI スラッシュコマンド

agy 内で / を入力すると、組み込みコマンドの呼び出しと自動補完が利用できます。

2.1 全般・セッション・履歴制御

コマンド 機能 備考・使い方
? / /help 利用可能なスラッシュコマンドとキーバインドを一覧表示 セッション中のクイックリファレンス
/config / /settings 全画面の対話型設定オーバーレイを開く 設定項目、テーマ、権限(settings.json)を編集
/clear 入力中のプロンプトバッファを空にして新規セッションを開始 無関係な別タスクへきれいに切り替え
/compact 会話履歴を圧縮・要約 長時間実行時にコンテキスト余力を回復
/resume 会話ピッカーを開いて以前のセッションを復元 中断した作業フローを再開
/rewind / /undo 会話ターンを1ステップずつ巻き戻す 誤ったターンや方針を取り消す
/fork 現在のチェックポイントから会話を分岐 並列ワークスペースブランチを安全に試行
/exit / /quit agy CLI セッションを終了 または Ctrl + D Ctrl + D

2.2 モデル・ワークフロー・エージェント・拡張機能

コマンド 機能 備考・使い方
/model セッション途中でアクティブな AI モデルを切り替え 速度・コストと推論性能のバランスを調整
/effort 推論 effort(low 〜 max)を確認または設定 注意: agy -p "/effort" は読み取り専用の JSON 出力
/plan ファイル変更前にステップごとの実行計画を生成 大規模なアーキテクチャ変更前の安全ゲート
/goal 途中の停止なしで完了まで自律実行 長時間にわたる目標達成タスク向け
/grill-me コーディング前に対話形式の要件ヒアリングを実施 エッジケースや受け入れ基準を事前に明確化
/agent カスタムサブエージェント/エージェントプロファイルを切り替え・呼び出し .agents/agents/ から定義を読み込む
/worktree 分離された Git worktree ディレクトリを作成・管理 メインツリーを汚さずに並列ブランチで作業
/mcp MCP 接続のリアルタイム状態・ログを確認し設定を再読み込み ローカル/リモート MCP サーバーのトラブルシュート
/plugin Marketplace プラグインの閲覧、有効化、無効化、詳細確認 同梱スキル、ルール、フック、MCP サーバーを管理
/voice 音声ディクテーション入力モードのオン/オフ切り替え ショートカットキーは F5

3. ターミナルキーバインド&入力構文

ショートカット / 構文 アクション 効果・利用シーン
@<path> ファイルパス自動補完 特定のファイルまたはディレクトリパスをコンテキストに挿入
!<command> インラインターミナル実行 先頭に ! を付けてシェルコマンドを直接実行(例: !npm run build)
Ctrl + G 外部エディタを開く 既定のエディタ(Vim、VS Code)で長文や複数行プロンプトを執筆
Esc Esc 入力中のプロンプト欄をクリア ストリーミング非実行時に保留中の入力を消去
F5 音声ディクテーション切替 /voice と同等
Ctrl + D Ctrl + D セッションを終了 Ctrl + D を2回押してクリーンに終了

4. 設定階層と mcp_config.json

4.1 グローバル設定 vs ワークスペース設定マップ

レイヤー グローバル範囲(全ワークスペース) ワークスペース範囲(プロジェクトローカル) 用途
CLI 設定 ~/.gemini/antigravity-cli/settings.json — CLI 環境設定、テーマ、エディタ、デフォルト権限
キーバインド ~/.gemini/antigravity-cli/keybindings.json — カスタムターミナルキー割り当て
プロジェクト指示書 ~/.gemini/AGENTS.md または GEMINI.md ./AGENTS.md または ./GEMINI.md リポジトリ固有の規約、ビルド/テストコマンド、役割設定
常時適用ルール ~/.gemini/config/rules/*.md .agents/rules/*.md コンテキストへ自動注入されるバックグラウンド制約
Agent Skills ~/.gemini/config/skills/<name>/SKILL.md .agents/skills/<name>/SKILL.md スクリプトやリソースを同梱するモジュラー Agent Skills パッケージ
MCP 設定 ~/.gemini/config/mcp_config.json .agents/mcp_config.json ローカル stdio およびリモート HTTP MCP サーバー定義

⚠️ リモート MCP の破壊的スキーマ変更(serverUrl): mcp_config.json において、リモート HTTP MCP サーバーは従来の url や httpUrl キーではなく必ず serverUrl を使用する必要があります。url を指定するとエラー出力なしでサイレントに接続失敗します。

{
  "mcpServers": {
    "remote-docs": {
      "serverUrl": "https://docsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "local-tool": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.example.com/mcp"]
    }
  }
}

5. 旧 Gemini CLI から agy への移行ガイド

Gemini CLI におけるコンシューマー無料枠および Google AI Pro/Ultra のリクエスト提供は 2026年6月18日 をもって終了しました(現在はエンタープライズ向け Gemini Code Assist と従量課金 API キー運用のみ存続)。agy への主な移行対応表は以下の通りです。

コンポーネント 旧 Gemini CLI Antigravity CLI (agy) 移行アクション
ランタイムとバイナリ オープンソース TypeScript (gemini) Go ベースのマルチエージェント CLI (agy) 呼び出しを agy に切り替え(起動時に自動オンボーディング実行)
拡張機能 Gemini CLI extensions ネイティブ Antigravity プラグイン agy plugin import gemini を実行して変換・インポート
指示ファイル GEMINI.md GEMINI.md および AGENTS.md 完全互換 — 既存の GEMINI.md をそのまま利用可能
ローカル Skill パス .gemini/skills/ .agents/skills/ スキルフォルダを .agents/skills/<name>/SKILL.md へ移動
旧 Workflows .agents/workflows/ Agent Skills へ移行 単一ファイルワークフローを .agents/skills/ 形式へ変換(/migrate-workflows)
MCP 設定とキー名 settings.json 内に url で記述 専用の mcp_config.json で serverUrl を使用 MCP ブロックを mcp_config.json へ分離し、url を serverUrl に変更

関連テーマ