Google Antigravity Remote Control：スマートフォンからエージェントを操作する方法

まだAntigravityをインストールしていない場合は、まずGoogle Antigravityとは何か、インストール方法を確認してください。このガイドは、エージェントが長時間かかる作業（リファクタリング、テストの実行、依存関係の移行など）を処理している間、セッションを操作できる状態を保ちながらデスクを離れたい場合を対象としています。

Remote Controlとは何か、なぜ必要なのか#

Remote ControlはGoogle Antigravityの機能です。自分のマシン上のデスクトップセッションやCLIセッションに安全に接続し、任意のウェブブラウザーから操作できます。公式の説明によると、サブシステム全体のリファクタリング、長時間のテスト実行、複雑な依存関係の移行など、大規模な作業には時間がかかることがあります。Remote Controlを使えば、パソコンから離れていてもセッションを管理でき、開発環境全体をローカルに保てます。

この機能はデスクトップアプリ2.0とCLI（ターミナル版Antigravityのagy）の両方で使えますが、有効化の方法と動作はそれぞれ異なります。

デスクトップ版Antigravity 2.0でRemote Controlを有効にする#

アプリの設定からRemote Controlを有効にできます。

1. Cmd + ,（LinuxとWindowsではCtrl + ,）を押してSettingsパネルを開くか、左パネル下部のSettingsボタンをクリックします。
2. Appセクションに移動します。
3. Enable Remote ControlをOnに切り替えます。
4. (任意) workstation-primaryやserver-machineなどのNicknameを設定すると、接続中のデバイス一覧でこのマシンを簡単に見分けられます。

スマートフォンまたは別のブラウザーから接続する

リモートセッションを開く手順は次のとおりです。

1. 任意のデバイスでブラウザーを開き、Antigravity Remote Controlダッシュボードにアクセスします。スマートフォンでは、ウェブアプリをホーム画面に追加すると、エージェントが作業を終えたときや返信を求めたときにプッシュ通知を受け取ることもできます。
2. デスクトップで使用しているものと同じGoogleアカウントでログインします。
3. デバイス切り替えメニューから目的のマシンを選択します。
4. 接続すると、進行中の会話を確認したり、エージェントに新しいタスクを開始させたり、実装計画や成果物を確認したりできます。

ウェブインターフェースにマシンが表示されない場合、公式の手順では次の3点を確認するよう案内されています。Antigravityを実行しているパソコンでEnable Remote Controlのトグルがオンになっていること、そのパソコンがインターネットに接続されておりスリープ状態になっていないこと、デスクトップアプリとブラウザーで同じGoogleアカウントを使っていることです。

接続に使用しているデバイスのネットワークが一時的に切断されると、ウェブインターフェースは自動的に再接続を試みます。Antigravityが動作しているパソコンがインターネットに接続されていれば、エージェントのバックグラウンドタスクとターミナルから起動したコマンドは中断されずに動作し続けます。

Antigravity CLIの2つのRemote Controlモード#

CLIには2つのモードがあります。特定のターミナルプロセスに紐づく対話モードと、ターミナルを開かずに動作するバックグラウンドのヘッドレスデーモンです。

対話モード：/remote-control

CLIを再起動せずに、現在の対話型agyセッションでRemote Controlを有効にできます。入力行で次を実行します。

/remote-control

公式の説明によると、CLIは現在のセッション用の接続、つまりリバーストンネルを開き、別のデバイスからアクティブな会話を開くためのホスト名とリンクを表示します。

Remote control on for this session.
Hostname: devbox-swift-falcon
Open https://antigravity.google.com/r/<instance-id>?p=c%2F<conversation-id> on another device to continue this conversation.

ノートパソコン、タブレット、またはスマートフォンのブラウザーでこのリンクを開き、CLIで使用しているものと同じGoogleアカウントでログインすると、Antigravityウェブインターフェースからセッションを続けられます。

ローカルのターミナルセッションを終了せずにトンネルを無効にするには、次を実行します。

/remote-control off

起動時にフラグを指定すると、Remote Controlを有効にした状態でCLIを開始できます。

agy --remote-control

対話モードはagyプロセスに紐づいています。CLIを終了する（/exit、Ctrl+C、Ctrl+D）か、ターミナルウィンドウを閉じると、Remote Controlのトンネルは自動的に終了し、ダッシュボードからセッションの項目が消えます。対話型CLIのプロセスごとに個別のセッションIDとホスト名があるため、複数のターミナルタブや作業ディレクトリでagy --remote-controlを同時に実行できます。

ブラウザーから対話型CLIセッションに接続すると、両側がリアルタイムで同期されます。リモートデバイスからのリクエストはローカルターミナルに直接届き、エージェントの推論、ツール呼び出し、コード変更はリモートインターフェースに表示されます。エージェントが確認（y/n）を求めたり、追加の質問をしたりした場合は、スマートフォンまたはローカルターミナルから応答できます。設定は例外です。リモートウェブインターフェースから設定を変更することはできず、CLI自体からのみ変更できます。

ヘッドレスデーモン：agy remote-control start

2つ目のモードは、OSのサービスとして登録される常駐型のバックグラウンドデーモンです。マシンの電源が入っていてインターネットに接続されている間は利用できます。ログアウト後や再起動後の動作はプラットフォームによって異なります。

agy remote-control start

デーモンはOSサービス（Linuxではsystemdユーザーサービス、macOSではLaunchAgent、Windowsではスケジュールされたタスク）として登録され、ターミナルウィンドウを開かずにすぐ起動します。

agy remote-control statusを使うと、項目名を確認できます。次にAntigravity Remote Controlダッシュボードでこのマシンを選択し、Antigravityウェブインターフェースから作業を続けます。

デーモンは次の3つのコマンドで操作します。

agy remote-control start     デーモンを登録して起動する
agy remote-control status    デーモンの状態とインスタンス名を表示する
agy remote-control stop      デーモンを停止して登録を解除する

デーモンはCLIへのサインインに使用した認証情報を使います。CLIへのサインインは、同じマシン上のAntigravityデスクトップエディターへのサインインとは別です。ブラウザーでは、CLIと同じGoogleアカウントを使用します。

起動時に--nameフラグを指定すると、ヘッドレスデーモンのマシン名を設定できます。

agy remote-control start --name "my-workstation"

新しい値を指定してstart --nameを再実行すると、マシン名が変更されます。

名前を設定しない場合、デーモンは初回起動時に覚えやすい名前（my-machine-distant-plumeなど）を生成します。現在の名前はagy remote-control statusで確認できます。設定ファイルから名前を変更することもできます。Linux/macOSでは~/.gemini/config/config.jsonを、Windowsでは%USERPROFILE%\.gemini\config\config.jsonを開き、cliRemoteControlHostnameの値を変更してファイルを保存し、agy remote-control startを実行してデーモンを再起動します。サービスの再起動後、ダッシュボードに新しい名前が表示されます。デーモンの実行中にファイルを変更しても反映されません。

このファイルには、似たフィールドが2つあります。cliRemoteControlHostnameは、ここで説明しているCLIデーモンの名前です。remoteControlHostnameは、同じマシン上のAntigravityデスクトップエディター用の別のフィールドです。Antigravity 2.0では、Settings → Appから変更できます。

ログアウト後と再起動後のデーモンの動作

動作はOSによって異なります。

Windows固有の詳細

システム起動時に自動起動するようデーモンを登録するには、管理者として実行する必要があります。PowerShellまたは通常のコマンドプロンプトを使用できます。startコマンドは通常のウィンドウからでも実行できますが、ログアウト後や再起動後にデーモンが再開するのは起動時ではなく次回のログイン時です。statusとstopコマンドは、管理者権限のない通常のウィンドウから実行できます。

どちらのモードを選ぶか

現在の作業をスマートフォンから管理するだけなら、対話モードで十分です。ターミナルを開かずにリモートアクセスする必要がある場合は、OSの条件に従ってヘッドレスデーモンを使います。

接続に問題がある場合の対処方法#

公式ドキュメントに記載されている問題と解決方法は次のとおりです。

詳しく調べるには、デーモンのログを確認します。Linuxではjournalctl --user -u antigravity-cli-daemon -n 50を実行します。macOSでは~/Library/Logs/antigravity-cli-daemon.logを確認します。Windowsでは%USERPROFILE%\.gemini\antigravity-cli\logにある最新のcli-*.logを確認します。

ヘッドレスデーモンを使うと、ターミナルを開かずにアクセスできます。パソコンとOSの動作条件に従い、外出中も利用できます。継続的なアクセスが不要になったら、agy remote-control stopでデーモンを停止します。

Claude Codeのリモート操作については、別の記事をご覧ください。Telegramを通じて別のエージェントを操作するには、TelegramでHermes Agentを設定する方法を確認してください。

次にすること#

CLIで作業中に現在のタスクから離れたい場合は、対話モードから始めましょう。ターミナルは開いたままにしてください。閉じるとトンネルが切断され、ダッシュボードからセッションの項目が消えます。ターミナルを開かずにマシンへアクセスするには、OSの制限に従ってデーモンを使います。

Ailootで、さらに多くの資料をご覧いただけます。