最新アップデート

ニュースに収録済みの直近3件です。全件はニュースから確認できます。

2026-11-05Antigravity CLI v1.5.0〜v1.5.1 — stdio ACP サーバー agy acp と --remote-agent を追加

agy acp で ACP クライアントから Antigravity CLI を使えるように(session/resume・ターン中の steer・agy acp --login)。--remote-agent で会話をリモートエージェント上で実行。挙動変更: ヘッドレスの -p はバックグラウンドタスクを既定で待ち、--print-timeout で打ち切られると終了コード 3。

セキュリティ: プラグインの OAuth トークンを Authorization ヘッダーの中でだけ置換し、サイトが実トークンをエコーバックできないように(v1.5.1)。ニュースを読む

2026-10-30Antigravity CLI v1.4.8〜v1.4.12 — PreInvocation hook でモデルの呼び出し前にターンを止められるように

PreInvocation hook が terminationBehavior: "terminate" でモデルを呼ぶ前にターンを止められるように。errorMessage.userMessage で、モデルには送らずユーザーにだけメッセージを表示できます(-p 実行では終了コードが 0 以外に)。画像の貼り付け・ドラッグ&ドロップに対応(SSH 越しは X11 か Wayland の転送が有効なとき)。

セキュリティ: Google サイトへの承認が、機密性の高い Google アプリにまで及ばないように。ニュースを読む

2026-10-24Antigravity CLI v1.4.7 — hook の入力に lastUserInput、プラグイン MCP の OAuth トークンの不具合を修正

hook が標準入力で受け取る JSON に最新のユーザーメッセージ lastUserInput が加わり、エージェントが動く前にプロンプトを検査できるように。

セキュリティ: OAuth でサインインするプラグインの MCP サーバーが、同じ OS アカウントの別ユーザーのトークンを使えた不具合を修正。ニュースを読む

概要とベストプラクティス

以前の記載からの訂正: 以前のこのページには「2026-06-18 の移行期限」「antigravity.toml での設定」「Jules・IDX と連携する3アプリ構成」「Gemini 2.5 Pro の 2M トークン」などを載せていましたが、移行期限はすでに過ぎており、そのほかは公式の情報で確認できませんでした。確認できた内容に書き直しています。

概要

  • Google 製。GUI のデスクトップアプリ Antigravity 2.0 と、ターミナルで動く Antigravity CLI(agy)がある
  • 2つは同じエージェントエンジンを使い、設定と権限は双方向に同期される。CLI のセッションを 2.0 に書き出して続きを作業できる
  • ルールは AGENTS.md と GEMINI.md。Skills・カスタムエージェント・Hooks・プラグイン・MCP で拡張できる
  • 権限は確認方式とサンドボックスで管理。Auto mode では安全な操作は確認なしで進む
  • Remote Control でブラウザからセッションを操作できる

ベストプラクティス 8

  1. プロジェクトの指示は AGENTS.md に書く(他のツールとも共有できる)
  2. 繰り返す手順は Skill(.agents/skills/<name>/SKILL.md)に切り出す
  3. 危険なコマンドの拒否や機密情報の検査は、指示文ではなく Hooks(PreToolUse・PreInvocation)で行う
  4. ターミナルのサンドボックスを有効にし、外に出るコマンドは確認させる
  5. 信頼していないリポジトリは、ワークスペースを信頼する前に .agents/hooks.json などの中身を確認する(ワークスペースの hooks は信頼した後に読み込まれる)
  6. プラグインは中身(MCP サーバー・hooks)を確認してから入れる
  7. --dangerously-skip-permissions は使い捨ての環境だけで使う
  8. AI エージェントにはコードの自動実行・データの持ち出し・プロンプトインジェクションなどの危険がある前提で、操作を確認する(README の警告)

CLI のインストールと起動

01インストール・ログイン
# 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
  • 認証はシステムのキーリングを使い、セッションがなければ Google でサインインします。SSH 越しでは認可用の URL が表示されます。/logout でサインアウト
  • GEMINI_API_KEY を設定し、settings.json で modelProvider: "gemini" にすると、サインインせずに Gemini API で動かせます
  • 企業で使う場合は、オンボーディングで GCP プロジェクトを接続します

インストールスクリプトを直接シェルに渡す方法は公式の手順ですが、実行前にスクリプトの中身を確認すると安全です。

02よく使うフラグとコマンド
コマンド・フラグ内容
-p / --print非対話で1回実行(--output-format json / stream-json で構造化出力)
--model / /model、--effort / /effortモデルと推論の深さを選ぶ
--mode実行モード(default・accept-edits・plan・auto)。Shift+Tab や /config でも切り替え
--agent / /agentsカスタムエージェントを選ぶ・一覧する
/compact会話を要約してコンテキストを空ける
/hooks読み込まれている Hook を確認
/plugin公式マーケットプレイスからプラグインを探す・入れる
/resume過去の会話を再開
/remote-controlブラウザからの操作を有効にする

出典: antigravity-cli README · CHANGELOG · CLI overview

設定ファイルの場所

01全体・プロジェクトの設定
~/.gemini/antigravity-cli/settings.json   # CLI の設定(権限・モード・モデルなど)
~/.gemini/config/                         # 2.0 と共有する全体の設定
  AGENTS.md  GEMINI.md  rules/            # 全体のルール
  hooks.json                              # 全体の Hook
  agents/                                 # 全体のカスタムエージェント
  plugins/  plugins.json  skills.json  rules.json  agents.json  mcp_config.json
  config.json                             # 共有設定(プラグインの有効・無効など)
  projects/                               # プロジェクトごとの権限

<プロジェクト>/.agents/
  hooks.json                              # プロジェクトの Hook
  agents/                                 # プロジェクトのカスタムエージェント
  skills/<name>/SKILL.md                  # プロジェクトの Skills
  • プロジェクトごとの権限(~/.gemini/config/projects/)は、全体の設定より優先されます
  • .agents/ の skills.json・rules.json などは、作業ディレクトリからプロジェクトのルートまでの各階層のものが読み込まれます
  • エージェントに読ませたくないファイルは .antigravityignore に書けます

出典: antigravity-cli CHANGELOG

ルールとカスタムエージェント

01ルール(AGENTS.md・GEMINI.md)
  • プロジェクトの AGENTS.md と、全体の ~/.gemini/AGENTS.md・~/.gemini/GEMINI.md(または ~/.gemini/config/ 内の同名ファイル)が読み込まれます
  • これらのルールは、組み込みの指示より優先されるように扱われます
02Markdown のカスタムエージェント
# .agents/agents/reviewer/agent.md
---
name: reviewer
description: Reviews diffs for security issues
model: inherit          # サブエージェントとして動くときのモデル(flash / pro など)
subagent: true
---
# Reviewer
You review code changes and report security issues only.
  • YAML フロントマターと、H1 見出しで始まるシステムプロンプトで書きます
  • フロントマターで skills・rules・agents・plugins・hooks を指定できます(エージェントのファイルからの相対パスも可)
  • 既定では、全体の Skills・ルール・サブエージェントを引き継ぎます(引き継ぐかどうかは inheritCustomizations で指定)。excludeDefaultComponents: true は、既定のプロンプトの一部と組み込みツールを外す設定です(post-invocation の hooks は残る)
  • subagent: false にするとサブエージェントとしては呼ばれません

出典: antigravity-cli CHANGELOG

Hooks

決まった時点でコマンドを実行する仕組みです。入力は標準入力の JSON で受け取り、結果を標準出力の JSON で返します。

01イベントと置き場所
イベントタイミング
PreToolUse / PostToolUseツールの実行前 / 後(matcher でツールを指定)
PreInvocationモデルを呼ぶ前。terminationBehavior: "terminate" でターンを止められる
PostInvocationモデルの呼び出しが終わった直後
Stopターンの終了時
  • matcher が使われるのは PreToolUse・PostToolUse だけで、PreInvocation・PostInvocation・Stop では無視されます
  • 置き場所: プロジェクトは .agents/hooks.json、全体は ~/.gemini/config/hooks.json、プラグインに含まれる hooks.json
  • hook の入力 JSON には、最新のユーザーメッセージ lastUserInput も含まれます(v1.4.7 から)
  • CLI で使えるイベントの正確な一覧(SessionStart など)は、公式ドキュメントの Hooks ページで確認してください

出典: Hooks(CLI) · CHANGELOG

権限とサンドボックス

01実行モード
モード動き
default確認しながら進める
accept-editsファイルの編集は確認なしで進める
plan計画を立てる
autoファイルの編集と安全なコマンドは確認なし、取り返しのつかない操作は確認する。サンドボックスの外に出るコマンドは別のエージェントが確認する。Windows では Windows 11 24H2 以降・個人の Google アカウントで使える

確認の画面で「常に許可」を選ぶと、許可ルールとして保存されます(settings.json の permission.allow が参照されるほか、Remote Control から承認したルールは共有の ~/.gemini/config/config.json に保存されるなど、保存先は経路によって異なります)。ヘッドレス(-p)の実行でも、保存した権限・サンドボックス・自動実行の設定が使われます。

02ターミナルのサンドボックス
  • エージェントが実行するコマンドを、ファイルやネットワークへのアクセスを制限した環境で動かします
  • 既定で ~/.docker・~/.kube・~/_netrc(v1.4.6 から)や、macOS の ~/Library/Application Support にはアクセスできません
  • Windows は Windows 11 24H2 以降で使えます(管理者権限は不要)。Linux で非特権ユーザー名前空間が使えない環境では使えません

出典: antigravity-cli CHANGELOG

プラグイン

01プラグインの管理
  • /plugin で公式マーケットプレイスのプラグイン(Skills・MCP サーバー・サブエージェント・ルール・hooks をまとめたもの)を探して入れます
  • 設定が必要な MCP サーバーを含むプラグインは、設定するまで無効の状態で入ります。Configure MCP servers... で後から変更できます
  • 自作のプラグインは agy plugin validate で plugin.json・hooks.json・Skills などの書き方を確認できます

出典: antigravity-cli CHANGELOG

ホームに戻る 比較表を見る