Antigravity CLI (agy) ユーザーガイド

このガイドでは、Antigravity のコマンドラインインターフェース（CLI）ツールである agy の概要、インストール、および使い方について説明します。

1. 概要

agy（Antigravity CLI）は、Google DeepMind の Advanced Agentic Coding チームによって開発された自律型 AI コーディングアシスタント「Antigravity」をコマンドラインから操作するためのツールです。

開発者が日常的に使用するターミナル上で、エージェントに対して直接指示を与えてタスクを実行させたり、過去の対話を再開したり、プラグインを管理したりすることができます。

2. インストールとセットアップ

agy は通常、実行可能なバイナリファイルとして配布されます。利用を開始するには、以下の手順で初期配置と環境のセットアップを行います。

2.1. 実行ファイルの配置

ダウンロードした agy の実行ファイル（Windows の場合は agy.exe）を、任意のディレクトリに配置します。まだ PATH が通っていない状態では、カレントディレクトリに配置して ./agy のように相対パスで実行するか、フルパスを指定して実行します。

2.2. シェル環境の初期セットアップ (`install`)

install サブコマンドを実行することで、agy の実行ファイルを自動的に適切なディレクトリ（Windows の場合は ~/.gemini/antigravity-cli/bin/ 等）へコピーし、実行ファイルの PATH やシェルの設定（プロファイルの整理など）を自動構成します。

Windows 環境では、ターミナルとして PowerShell 7.x (pwsh.exe) の使用が強く推奨されています。

./agy install [オプション]

主なオプション：

--dir <path>: agy の実行ファイルをコピーし PATH を構成するカスタムターゲットディレクトリを指定します。
--skip-aliases: シェルプロファイルからの不要なエイリアスの自動削除（パージ）をスキップします。
--skip-path: シェルプロファイルへの PATH 追加をスキップします。

3. 基本的な使い方

agy のメインコマンドは、プロンプトをインタラクティブまたは非インタラクティブ（ワンショット）で実行し、エージェントとの対話を開始します。

3.1. インタラクティブモードで開始する (`-i`, `--prompt-interactive`)

最初のプロンプトを指定して対話セッションを開始し、そのまま対話を継続します。対話中、エージェントがファイル書き換えやコマンド実行などのツールを使用する際は、ターミナル上でユーザーに承認（Y/n 等）を求めるプロンプトが表示され、安全に実行をコントロールできます。

agy -i "src/utils.js に日付フォーマット関数を追加してください"
# または
agy --prompt-interactive "src/utils.js に日付フォーマット関数を追加してください"

3.2. 非インタラクティブ（ワンショット）で実行する (`-p`, `--print`, `--prompt`)

単一のプロンプトを非インタラクティブに実行し、エージェントの最終回答のみを標準出力に表示して終了します。スクリプトや CI/CD パイプラインなどの自動化に適しています。

agy -p "docs/README.md のタイポを修正してください"
# または
agy --print "docs/README.md のタイポを修正してください"
# または
agy --prompt "docs/README.md のタイポを修正してください"

タイムアウトの調整： 非インタラクティブ実行時、エージェントの思考や処理が完了するまでの待機タイムアウトを指定できます（デフォルトは5分）。

agy -p "複雑なタスク" --print-timeout 10m

3.3. 前回の会話を再開・継続する

直近の会話を継続する (-c, --continue) 最後に実行した会話セッションをそのまま引き継いで再開します。

agy -c
# または
agy --continue

会話IDを指定して再開する (--conversation) 過去の特定の会話IDを指定してセッションを再開します。会話IDは ~/.gemini/antigravity-cli/brain/ ディレクトリ配下のフォルダ名から確認できます。

agy --conversation <CONVERSATION_ID>

3.4. その他のメインオプション

ワークスペースに他のディレクトリを追加する (--add-dir) 現在のカレントディレクトリ以外のディレクトリをワークスペースの探索範囲に追加します。複数指定が可能です。

agy --add-dir /path/to/another/dir --add-dir /path/to/second/dir

サンドボックスでの実行 (--sandbox) セキュリティを強化するため、一部のターミナル操作やコマンド実行が制限されたサンドボックス環境下でエージェントを動かします。

agy --sandbox -i "コードを分析してください"

パーミッション確認をスキップする (--dangerously-skip-permissions) 通常、エージェントがコマンドを実行したり、ファイルを書き換えたりする際にはユーザーへの承認プロンプトが表示されます。このオプションを指定すると、すべてのツール実行を自動で承認します。

Caution

予期しないコマンド実行やファイルの破壊が発生する可能性があるため、信頼できる環境以外での使用は避けてください。

agy --dangerously-skip-permissions -p "ビルドとクリーンアップを実行してください"

ログファイルのパス変更 (--log-file) CLI の実行ログファイルの出力先を標準のパスから変更します。

agy --log-file ./my-agy-run.log

4. サブコマンド

agy には環境のセットアップやプラグイン管理を行うためのサブコマンドが用意されています。

4.1. プラグイン管理 (`plugin` / `plugins`)

エージェントの機能を拡張するためのプラグイン（MCPサーバーやカスタムツールなど）を管理します。

インポートされたプラグインのリスト表示

agy plugin list

Gemini または Claude からのプラグインのインポート 指定したソース（gemini または claude）からプラグインをインポートします。
```
agy plugin import gemini
```
プラグインのインストール マーケットプレイス上のプラグインを指定してインストールします。
```
agy plugin install plugin@marketplace
```
プラグインのアンインストール

agy plugin uninstall <name>

プラグインの有効化 / 無効化

agy plugin enable <name>
agy plugin disable <name>

プラグインの検証 指定したマニフェストファイルやプラグインディレクトリのパスにあるプラグインが正しく定義されているか検証します。
```
agy plugin validate ./my-plugin/
```
マーケットプレイスへのリンク生成

agy plugin link <mp> <target>

4.2. CLIのアップデート (`update`)

インストールされている agy CLI ツール自体を最新バージョンにアップデートします。

agy update

4.3. 変更履歴の確認 (`changelog`)

CLI のバージョン更新に伴う変更点やリリースノートを表示します。

agy changelog

5. アプリケーションデータとログ

CLI による会話のログやアーティファクトは、以下のローカルパスに保存されます。

ログ・設定の保存場所: ~/.gemini/antigravity-cli/
各会話のアーティファクトとログ:
- ~/.gemini/antigravity-cli/brain/<conversation-id>/
- 詳細な実行履歴 (JSONL 形式): ~/.gemini/antigravity-cli/brain/<conversation-id>/.system_generated/logs/transcript.jsonl

Tip

動作が不安定な場合や、エージェントが過去にどのようなツールを実行したかを確認したい場合は、transcript.jsonl を直接参照するか、grep などのツールで検索すると便利です。

Keyboard shortcuts