Antigravityのリモートコントロールの使い方とCLIの設定方法

Google Antigravityのリモートコントロールを使うと、ブラウザからご自身のマシン上で動作するエージェントのセッションへ、接続して操作できます。2026年9月にはAntigravity CLIにも常駐デーモンを管理するコマンドが加わり、デスクトップとCLIのどちらからでも使うことができるようになりました。

Antigravityのremote controlはスマホからも使える

Antigravityのリモートコントロールを使うと、スマホやノートPCのブラウザから、ご自身のマシンで動作中のセッションを操作できます。 接続するとブラウザ上で、進行中の会話を閲覧したり新しいタスクを始めたり、実装プランや成果物を確認したりできます。ご自身のマシンにあるファイル・認証情報・環境変数にもそのままアクセスできるので、別のPCで環境を再構築する必要はありません。

スマホではウェブアプリをホーム画面に追加しておくと、エージェントの作業が終わったときや入力を求められたときにプッシュ通知を受け取れます。重い処理を任せて席を離れているあいだも、進捗を確認したり変更をレビューしたりする作業を外出先から継続できます。

"retain full access to your files, workspaces, build tools, credentials, and environment variables"/"you can monitor progress, review changes, and execute commands on that machine" — ブログ記事より
公式情報を見る →
"you can optionally install the web app to your home screen to receive push notifications when agents complete tasks or request input" — Connecting from a web browser の節より
公式情報を見る →

Antigravityデスクトップの使い方は設定でオンにして接続するだけ

Antigravityデスクトップ(Antigravity 2.0)では、設定画面でリモートコントロールをオンにしてから、ブラウザで接続します。また、次の手順で設定を1度完了させておけば、次回からはブラウザでデスクトップと同じGoogleアカウントにサインインし、マシンを選ぶだけで操作できます。

  1. Cmd+,(LinuxとWindowsはCtrl+,)を押すか、左サイドバー下部のSettingsから設定画面を開く
  2. Appセクションを開きEnable Remote ControlをOnにする
  3. 必要ならNicknameに識別しやすい名前(例: workstation-primary)を設定する
  4. ブラウザでダッシュボードを開き、デスクトップと同じGoogleアカウントでサインインする
  5. インスタンスの切り替えメニューから操作したいマシンを選ぶ

利用中のネットワークが一時的に切れても、ウェブ側は自動で再接続を試みます。また、実行中のバックグラウンドタスクやシェルコマンドは、そのままご自身のマシン上で動作し続けます。

"Toggle Enable Remote Control to On."/"Sign in with the same Google Account that you used on your desktop application." — Antigravity 2.0 の設定手順より
公式情報を見る →

Antigravity CLIの使い方は一時接続と常駐の2通り

Antigravity CLIのリモートコントロールには、実行中のターミナルでその場だけオンにする方法と、マシンに常駐させる方法の2通りがあります。 ターミナルでagyを実行中なら、プロンプトで/remote-controlを入力すれば再起動せずにオンにでき、起動と同時にオンにするなら、agy --remote-controlで立ち上げます。

どちらの方法でも、ホスト名と、他の機器で会話を引き継げるURLが表示されます。一時的に接続した状態は、そのターミナルが開いているあいだだけ有効で、/exitやCtrl+Cで終了したりターミナルを閉じたりすると自動で切れてダッシュボードからも消えます。

ターミナルごとに別のIDが振られるため、複数のタブやプロジェクトで同時に使うことができます。/remote-control offで切断した場合は、ローカル環境のターミナルセッションだけが続くとのこと。

ターミナルを開いていないときも接続したままにしておきたい場合は、agy remote-control startで常駐デーモンとして登録します。登録するとターミナルを閉じたあとも接続が維持されます。

"Start a Remote Control connection in an active CLI instance using /remote-control or start it in a new instance by launching the CLI with the --remote-control flag."/"Tunnel stays open only for the lifetime of that CLI instance." — Antigravity CLI の節より
公式情報を見る →

CLIの常駐デーモンはOSごとに設定と挙動が異なる

CLIの常駐デーモンはagy remote-control startで登録するとOSのサービスとして動き、ターミナルを開かなくても接続を維持します。 登録先のサービスはOSによって異なり、デーモンのサインインにはCLIの認証情報が使われ、同じマシンにあるエディタ側のサインインとは別に管理されます。

管理コマンドは2026年9月10日のCLI 1.2.0で追加されました。コマンドは次の3つです。

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

マシンの名前はagy remote-control start --name "my-workstation"のように--nameで指定し、省略すると初回起動時にmy-machine-distant-plumeのような名前が自動で付与されます。設定ファイルで変更する場合はconfig.jsonのcliRemoteControlHostnameを書き換えてからstartを再実行します。

OSごとに異なる常駐デーモンの挙動

挙動 Linux macOS Windows
登録されるサービス systemdのユーザーサービス LaunchAgent Scheduled Task
起動のタイミング 起動時(ログイン不要) ログイン時 管理者で登録すれば起動時・それ以外はログイン時
サインアウト後も動作するか 動作する 停止し次のログインで再開 起動時に登録していれば動作する
クラッシュ後の復帰 自動 自動 3回まで自動で再起動し以後は次の起動かstartの再実行

Windowsで起動時に動作させるには、PowerShellかコマンドプロンプトを管理者として開いて登録する必要があり、通常のプロンプトでstartを実行した場合は、その場では動作しても再ログインするまで再開しません。config.jsonにはエディタ側のremoteControlHostnameという似た名前の値もあるので、書き換える値を間違えないように注意します。

"The daemon registers as an OS service (a systemd user service on Linux, a LaunchAgent on macOS, or a Scheduled Task on Windows)"/"Registering the daemon to start at boot requires an Administrator prompt. PowerShell and Command Prompt both work." — Remote Control Headless Daemon の節より
公式情報を見る →
"Added remote-control start, remote-control status, and remote-control stop subcommands" — チェンジログより
公式情報を見る →

スマホからremote controlに接続できない時

remote controlにスマホや他のPCから接続できないときは、接続先マシンの設定とアカウントを順にチェックすると原因を切り分けられます。まずデスクトップ側で、次の3つの条件を満たしているかを確認します。

  • 設定でEnable Remote ControlがOnになっている
  • マシンがインターネットに接続されスリープしていない
  • デスクトップとブラウザで同じGoogleアカウントにサインインしている

「Remote control is not enabled for your account.」と表示される場合はアカウントや組織のポリシーで機能が無効になっています。ワークスペースの管理者に問い合わせるか、契約しているプランが対応しているかをチェックします。

CLIの接続が何度も切れては戻るときは、古いスクリプトで登録した常駐サービスが削除されずに、新しいデーモンと接続を取り合っていることがあります。この場合はagy remote-control startをもう一度実行すれば古い登録が自動で消えますが、それでも解消しないときはデーモンのログを見て切り分けます。

  • Linux: journalctl --user -u antigravity-cli-daemon -n 50
  • macOS: ~/Library/Logs/antigravity-cli-daemon.log
  • Windows: %USERPROFILE%\.gemini\antigravity-cli\logにある最新のcli-*.log
"Ensure that Enable Remote Control is toggled on in Antigravity 2.0 Settings on your host machine."/"an old script-installed daemon may still be registered and fighting this one for the connection" — Troubleshooting の節より
公式情報を見る →

リモートコントロールを利用する3つの方法

Antigravityのリモートコントロールはデスクトップの設定か、CLIの/remote-controlとagy remote-control startのどちらかで利用できます。 席を離れるだけならターミナルごとの/remote-controlで十分ですが、常に外から使うなら常駐デーモンを登録しましょう。Windowsでは、管理者のプロンプトで登録すると再起動後も自動接続されます。

FAQ

Antigravityのリモートコントロールはスマホからも使えますか?
使うことができます。ブラウザさえあれば機器は問いません。スマートフォンではリモートコントロールのウェブアプリをホーム画面に追加でき、エージェントがタスクを終えたときや入力を求めたときにプッシュ通知を受け取れます。
どのバージョンからリモートコントロールに対応しましたか?
Antigravity 2.0のv2.9.1です。2026年8月20日のチェンジログで、ローカルPCのエージェントセッションへブラウザから安全に接続して操作できる機能として追加されました。エージェントがタスクを完了したときや、入力を必要としたときのプッシュ通知も同時に入っています。
エディタを起動していないサーバーにも接続できますか?
できます。Googleは、ノートパソコンとサーバーとデスクトップを接続先の例に出しています。画面を持たないサーバーではCLIでagy remote-control startを実行して常駐デーモンを登録すると、エディタを開かなくても接続先として使うことができます。
通信が切れるとエージェントの作業は止まりますか?
止まりません。利用中のネットワークが一時的に落ちてもウェブ側は自動で再接続を試みます。実行中のバックグラウンドタスクとシェルコマンドは、ホストマシンがインターネットに接続している限り中断されずに走り続けます。