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 に変更 |