スマートフォンから 1DevTool を操作する

Remote Control を使えば、LAN・Cloudflare トンネル・Tailscale 経由でスマートフォンからエージェントの実行、diff のレビュー、プランの承認、チームの監視ができます。

Remote Control を使うと、1DevTool が動いているマシンをスマートフォンから操作できます。ソファからエージェントを起動したり、電車の中で diff をレビューしたり、入力待ちのプロンプトに返信したりできます。ノート PC を開く必要はありません。すべての処理はお使いのマシン上で実行され、スマートフォンはあくまでリモコンとして機能します。

スマートフォンで表示した 1DevTool Remote Control のプロジェクト一覧

有効にする

  1. デスクトップのステータスバーから Remote Control を開き、有効にします。
  2. 1DevTool がプライベート URL と QR コードを生成します。スマートフォンで QR コードをスキャンするか、モバイルブラウザで URL を開いてください。
  3. 求められたらサインインします。接続はお使いのマシンに紐づいており、アクセスできるのはあなただけです。

3 つの接続モード

  • Local Network — スマートフォンとデスクトップが同じ Wi-Fi に接続されている場合に使います。
  • Cloudflare Tunnel — 安全な Cloudflare トンネルを利用するため、ポートを公開したり VPN を設定したりする必要がありません。
  • Tailscale / VPN — 自分の tailnet を通じて、スマートフォンからデスクトップに接続します。

Tailscale をお使いなら、設定する価値があります。パブリックインターネットには何も公開されず、トンネルの起動待ちもなく、iOS の Safari をそのまま使えます。そのため、自宅ネットワークでアプリ内のスキャナーブラウザを使わざるを得ない、ということもありません。パネルには Tailscale がインストール済みか、起動しているか、接続できているかがわかりやすく表示され、QR コードとペアリング URL は tailnet のアドレスに切り替わります。tailnet で HTTPS を有効にする必要がある場合は、ガイド付きの 1 回限りの手順で設定できます。

起動時に開始

Settings → Remote で Start on Launch をオンにすると、1DevTool を開くたびにリモートサーバーが起動します。ペアリング済みのスマートフォンは、再起動やアップデートの後も自動的に再接続されます。スイッチの横のバッジには、起動時に使われるモードが表示されます。

  • Local Network — アプリを開くとすぐに、Wi-Fi 上でサーバーが立ち上がります。
  • Tailscale — 再起動後に Tailscale がまだ接続中の場合、1DevTool は最大 2 分間待機し、その間はローカルネットワークで提供します。
  • Cloudflare Tunnel は公開されるため、自動では起動しません。このモードを選択している間はスイッチがオフになります。使うには Local Network または Tailscale を選んでください。

Tailscale / VPN を選択し、Start on Launch スイッチをオンにした Settings の Remote 画面

スマートフォンアプリ

アプリの入手方法。 iPhone と iPad では App Store から 1DevTool をインストールしてください。無料で、iOS 17 以降が必要です。Android では Google Play から 1DevTool をインストールしてください。こちらも無料で、Android 8.0 以降が必要です。

Settings → Remote には 2 つのタブがあります。このページで説明している内容すべてにあたる Web UI と、今も Beta タグが付いている Phone です。Phone タブでは 1DevTool モバイルアプリのホストを管理します。ホストはデフォルトでオフです。オンにすると、ローカルネットワークまたは Tailscale の tailnet 上で Remote Control のポートを待ち受けます。通信はエンドツーエンドで暗号化され、リレーやトンネルは使われません。Cloudflare トンネルはブラウザクライアント専用です。

Phone タブには、セットアップガイド Read how to install and use the 1DevTool mobile app beta → へのリンクもあります。こちらからも読めます。このガイドはベータ版向けに書かれたものなので、iPhone では TestFlight ではなく App Store から、Android では招待を待たずに Google Play からインストールしてください。それ以外のセットアップ手順はそのまま使えます。

このセクションには、スマートフォンから接続できるアドレスの一覧と、10 分で期限切れになる Pairing code が表示され、Copy code と New code を使えます。アプリで Add computer を選び、コードをスキャンしてください。スマートフォンは Viewer としてペアリングされ、その後 1DevTool がどのロール(Viewer、Approver、Operator、Admin)を付与するかを確認してきます。ターミナルへの入力には Operator が必要です。コード 1 つでペアリングできるのは 1 台で、5 回失敗すると無効になります。同一アドレスからのペアリング試行は 1 分あたり 20 回まで、ペアリングできるスマートフォンは最大 32 台です。ペアリング済みのスマートフォンはプラットフォームと最終接続日時とともに一覧表示され、名前の変更、ロールの変更、または Forget(ライブセッションも終了します)ができます。

ペアリングは 1 回限り、まずは読み取り専用

  • QR 招待は 1 回だけ使え、10 分で期限切れになります。 スキャンするとコードは消費され、新しいコードに置き換わるため、撮影されたコードや古いコードを使い回すことはできません。ペアリングの応答自体も暗号化されて送信されます。
  • 新しいスマートフォンは、別途設定しない限り Viewer として接続します。 ファイルやトランスクリプトを含む、このデスクトップのワークスペースを読み取れますが、操作を行うにはより上位のロールが必要です。詳しくは下記の Permissions をご覧ください。
  • QR ペアリング時のロールは記憶させることができます。 デバイスが QR コードをスキャンしたときのロールダイアログで Don’t ask again にチェックを入れるか、Settings → Remote の New QR Devices を Ask every time または固定のロールに設定してください。Viewer より上位のロールを選ぶ場合は、必ず事前に確認が求められます。パスコードによるサインインでは常に確認されます。

スマートフォンがペアリングされたままになる期間

Settings → Remote → Pairing Expiry では、7 days、30 days、90 days max から選べます。無期限の認証情報はなくなりました。

ブラウザのペアリングは、どのオプションを選んでも、ペアリングから最長 7 日で期限切れになり、利用しても更新されません。 毎日スマートフォンを使ってもアクセス期間は延びません。1 週間が経ったら、再度ペアリングしてください。設定を変更すると既存のペアリングが短くなることはあっても、長くなることはありません。

HTTPS の Remote URL では、ブラウザはペアリングの自分側の情報を、エクスポート不可の鍵として保護されたストレージに保持します。そのため、ページのストレージを読み取るスクリプトに持ち出されることはありません。通常の HTTP ではペアリングはそのタブの間だけ有効で、再読み込みすると新たにペアリングが必要になります。HTTPS の URL を使うことをおすすめします。

接続すると、デスクトップでの整理のままプロジェクトがスマートフォンに表示されます。タップすると、そのワークスペースに入れます。

スマートフォンでできること

Remote Control は、キーボードから離れているときに必要になる 1DevTool の機能を再現します。

AI エージェントにプロンプトを送り、操作する

任意のプロジェクトのターミナルを開き、エージェントの最新の出力を読んで、新しいプロンプトを送信できます。あなたの承認待ちで止まっているエージェントにも送れます。次のことができます。

  • モバイル向けの reader mode でターミナルのテキストをスクロール、コピーする
  • スマートフォンから 画像を添付 してプロンプトに含める
  • リポジトリ内のファイルを メンション して、エージェントに適切なコンテキストを渡す
  • プロンプト履歴 から過去のプロンプトを再利用する

スマートフォンでのプロンプト履歴

コードをレビューして Git でリリースする

プロジェクトのファイルを閲覧し、コミットの詳細を開き、スマートフォンで diff をレビュー できます。変更に問題がなければ、ステージしてメッセージを書き、プッシュするまで、ソース管理の一連の流れを手のひらの上で完結できます。

Remote Control でのファイルビューアーと Git 操作

API をテストし、データベースにクエリを実行する

HTTP リクエスト を送ってレスポンスを確認したり、データベースクエリ を実行したりできます。デスクトップで設定済みのコレクションや接続をそのまま使えます。保存したリクエストは、スマートフォンとデスクトップの間で同期されます。

Remote Control からデータベースクエリを実行しているところ

プロンプトを後で実行するようスケジュールする

Agent Input のプロンプトをキューに入れ、タイマー、指定時刻、または 次のクォータリセット のタイミングで実行できます。外出中に長いタスクを開始し、戻ったときには結果が揃っている、といった使い方ができます。

タイマーで Agent Input のプロンプトをスケジュールしているところ

トランスクリプトをしっかり読む

Reader Mode はエージェントとの会話をドキュメントとして再レンダリングするため、スマートフォンでも経緯を追いやすくなります。ユーザーのメッセージ、エージェントの結果、コード、ターミナルの生出力はそれぞれ別のスタイルで表示されます。閲覧画面は ライト、セピア、ダーク から選べ、デフォルトではデバイスのテーマに従います。

スマートフォンでの Reader Mode

画面サイズに合わせたターミナル

スマートフォンでターミナルを開くと、画面に合わせて折り返されます。ターミナルを実際に見ているスマートフォンが幅を決めるため、デスクトップ幅のグリッドを横にスクロールする必要はなく、行は画面に合わせて折り返されます。最新の出力とエージェントの入力欄が、見やすい位置に表示されます。

2 台のスマートフォンで同時に表示している場合は、両方に適したサイズに調整されます。ターミナルを閉じると、デスクトップのペインは元のサイズに戻ります。スマートフォンが接続している間、デスクトップのペインには Sized for phone のバッジと Reader Mode へのショートカットが表示されます。読み取り専用のビューアーは、これまでどおりミラー表示のままです。

これは ペアリング済みのコンピューター 上で動くターミナルでも同じです。Host ピッカーから開くと、スマートフォンの幅に合わせて表示されます。テキストサイズバーの A− と A+ で桁数を変更でき、スマートフォンが幅を保持している間、そのコンピューターのペインには Sized for phone · <phone> via <computer> と表示されます。ターミナルから離れると、デスクトップのサイズに戻ります。ペアリング済みのコンピューターが古いバージョンの 1DevTool を実行している場合や、アクセス権が閲覧専用の場合は、ターミナルはそのコンピューターの幅のままになり、テキストサイズパネルにその理由が表示されます。全文を読むには Open Reader を使ってください。

キッチンからプランを承認する

あなたの判断を待っているタスクには、専用のページが用意されています。プランを読んで、Approve または Request changes を選びます。あなたの言葉はそのままエージェントに届き、離席中に自動承認されることはありません。Approval Gates をご覧ください。

チーム全体をマップで見る

Maps タブ(Agents、Projects、Inbox の隣)では、各プロジェクトがライブマップとして描かれます。エージェントのターミナルは 1 つ 1 つがデスク、2 つのエージェントをつなぐリンクは線で表され、レイアウトは指揮系統に沿っています。組織図は階層を保ち、チームのホストはメンバーの上に配置され、リンクのないエージェントはマップの下の Not linked リストで待機します。

  • プロジェクトを選ぶ: Maps — Live terminals & links の下にあるチップから選びます。サマリー行には 4 agents · 3 links · 4-seat org のように表示され、空席があればその名前も示されます。
  • デスクを読み取る: 各デスクにはロールと状態が表示されます(例: devin · running)。あなたの対応を待っているデスク(AI の実行が終わったばかり、またはチームメンバーが入力を必要としているとフラグが立っている)にはマークが付き、ヘッダーに件数が表示されます(3 needs you)。
  • 線を読み取る: 実線は有効なリンク、破線は quarantined(隔離中)のリンクです。ターミナルが閉じた、または再起動した、セッションが置き換えられた、エージェントやワークツリーが変更された、といった理由で一時停止されています。直線は双方向にメッセージを運び、曲線は一方向のみです。
  • デスクをタップ すると、そのターミナルがスマートフォンで開きます。
  • リンクのリクエストが待機中のときは、1 link decision waiting — answer in Inbox というバナーが表示されます。

以前は専用の Team タブにあったチーム、階層、実行のビューは、マップの下の Start リストにある Teams, runs & logs にあります。同じ図のデスクトップ版については Team Map をご覧ください。

スマートフォンの 3 つの画面。保存済みチャートと Start team ボタンのある Orchestrate Agents シート、4 つのリンクされたエージェントのデスクを表示するライブ Maps ビュー、対応が必要な 3 つのエージェントにフラグが立った同じマップ

保存済みのチームを開始する

デスクトップの Builder で保存した組織図やパイプラインは、スマートフォンから開始できます。プロジェクトの Orchestrate Agents シートを開いて Add Terminal → Orchestration を選ぶか、Maps タブで Start a team from a chart をタップしてください。

各チャートはカードで表示され、ロールやステージと、開くターミナルの数(opens 4)がわかります。Preview では、Builder と同じように、組織図ならロールカードと報告ラインで、パイプラインなら番号付きのステージで表示されます。Start team は、チャートによってすでにリンクされた状態で、すべての席を新しいターミナルとして開き、処理中は Opening 2/4 terminals… とカウントします。

  • スマートフォンからは、すべての席が新しいターミナルで開きます。 すでに開いているターミナルを席に割り当てられるのは、デスクトップのみです。
  • 稼働中の席があるチャートは置き換えられません。 そのチャートがすでにプロジェクトで実行されている場合、ボタンは無効になり、そのチャート名が表示されます。停止または置き換えはデスクトップから行ってください。
  • チームの開始には、そのデバイスの Operator アクセスが必要です。

条件に合う保存済みチャートがない場合は、Plan a team from a goal を使うと、プランナーがメンバーを提案します。承認するまで何も実行されません。

ペアリング済みのコンピューターでエージェントを開始する

スマートフォンの Host ピッカーでペアリング済みのコンピューターを選び、そこでプロジェクトを開いて Add Terminal を選びます。シートには、そのコンピューターで検出された AI エージェントだけが表示され、Start on に続けてコンピューターの名前を選ぶと開始できます。これには、スマートフォンでの Operator または Admin アクセスと、ペアリング済みのコンピューター側の Start terminals 許可が必要です。

そこでエージェントが初回起動時の質問で止まった場合、スマートフォンがその内容を示し、ワンタップで回答できます。

エージェント質問ボタン
Codexこのフォルダを信頼するTrust folder
Codex起動前にアップデートするSkip update
Cursor Agentこのワークスペースを信頼するTrust workspace
OpenCode起動前にアップデートするSkip update
Devinこのフォルダの作成者を信頼するTrust folder

コンピューター間の会話を操作する

2 台のコンピューター上のエージェント間の会話は、Inbox に表示されます。Approver、Operator、Admin のデバイスは Pause conversation、Resume、End、Deliver now を実行できます。閲覧専用のデバイスには、一時停止や終了はデスクトップで行うよう案内が表示されます。

リンクリクエストとキュー内のメッセージを承認する

Inbox タブでは、スマートフォンからリンクリクエストを許可したり、キューに入っているメッセージを送出したりできます。タップする前に、何を許可するのかがわかるよう、権限のチップが表示されます。判断できるのは Approver のデバイスで、閲覧専用のデバイスにはリクエストが表示され、デスクトップで確認するよう案内されます。読み取りアクセスを求めるリンクは、スマートフォンからは拒否のみ可能です。承認にはデスクトップでの開示内容の確認が必要なためです。

スマートフォンで階層を確認する

Teams, runs & logs には、稼働中の各組織がレベルごとに表示されます。ホストが一番上、メンバーがその下に並び、各デスクはエージェントの実際の状態に合わせて点灯します。見た目はデスクトップと同じオフィス風で、空席やルーティング違反も表示されます。Approver のデバイスでは、ワンタップで席を再割り当て できます。Agent Hierarchy をご覧ください。

オーケストレーションの実行ログを読む

最近の実行を閲覧し、実行ごとのファイルを開き、アプリのログを読めます。席まで戻る必要はありません。

AI クォータを確認する

AI Quota セクションには、プロバイダーごと、アカウントごとの残量が表示されます。長時間の実行が夜通し持つかどうかを、開始する前に確認できます。Accounts & Quota をご覧ください。

スキルとスラッシュコマンド

スキルピッカーはスマートフォンでも使えるため、スキルやスラッシュコマンドの名前を思い出しながら入力しなくても挿入できます。

スマートフォンでのスキルピッカー

通知

アクティビティ通知 をオンにすると、エージェントが完了したとき、入力が必要になったとき、長時間実行中のコマンドが終わったときにスマートフォンが知らせてくれます。アプリを開いたままにしなくても、いつ作業に戻ればよいかがわかります。

Remote Control からのアクティビティ通知

Permissions

ペアリングされたすべてのデバイスにはロールがあり、デスクトップの Settings → Remote でデバイスごとに設定します。

ロール許可される内容
Viewerファイルやトランスクリプトを含む、デスクトップのワークスペースの読み取り。QR ペアリングに対して Settings → Remote の New QR Devices で別のロールを指定していない限り、新しいペアリングはすべてここから始まります。
Approverエージェントのアクションやタスクゲートの承認。破壊的な結果につながる可能性があります。
Operator / Adminこのデスクトップのワークスペースに対する幅広いコマンド実行と書き込みアクセス。localhost ポートのプレビューを開くことも含みます。

デバイスを Viewer より上位に引き上げる際は、デスクトップで確認が求められ、そのデバイス名と実行できるようになる内容が表示されます。デバイスのロールを下げると、以前のレベルのまま接続が残るのではなく、ライブ接続はただちに切断されます。スケジュールされたプロンプトは、実行時刻になった時点でデバイスの権限を再確認します。これらのロールが導入される前にペアリングされたデバイスは Viewer にリセットされており、デスクトップ上でその旨が表示されるので、より広いロールを改めて確認のうえ付与できます。

localhost ポートのプレビュー には Operator または Admin が必要です。それぞれのプレビューには、ペアリングに依存せず、そのポート専用の短期間の許可が付与されます。期限が切れると、スマートフォンからプレビューを開き直すよう求められます。

デスクトップが確認できない送信は、むやみに再試行されません。 プロンプトがターミナルに届いたかどうかをスマートフォンが確認できない場合、入力欄に Check terminal before resending という警告が表示され、下書きは保持され、元のエラーは Details の中に表示されます。そのため、軽い気持ちで再試行してもプロンプトが 2 回送られることはありません。

関連ページ

  • AI エージェントを実行する — エージェントへのプロンプト送信とオーケストレーションのデスクトップ側
  • AI Usage & Quota — 使用状況のピルはスマートフォンにも表示されます
  • Reader Mode — 小さな画面でトランスクリプトを読む
  • Approval Gates — どこからでもエージェントに回答する
  • Accounts & Quota — クォータセクションのデスクトップ版ビュー
  • Paired Devices — スマートフォンではなく、2 台目のコンピューター向けの同じ仕組み