別のデバイスからの GitHub Copilot CLI セッションのステアリング

Copilot CLI セッションのリモート 制御を有効にすると、進行状況を監視し、プロンプトに応答し、GitHub.comまたはGitHub Mobileから作業を続行できます。

この記事で

リモート コントロールを使用すると、任意のブラウザーまたはCopilot CLIから実行中のGitHub Mobile セッションに接続できます。 セッションの出力を表示し、アクセス許可要求に応答し、セッションが実行されているマシンにいない状態でセッションで作業を続けることができます。

この記事では、リモート コントロールを有効にして使用する方法について説明します。 概念の詳細については、「 AUTOTITLE」を参照してください。

リモート アクセスは、セッションの同期とは異なります。 Copilot CLI セッションは既定でGitHub アカウントに同期され、同期されたセッションはGitHub.comとGitHub Mobileでは表示専用として表示されます。 これらのセッションは操作できません。 セッションをリモートで操作するには、リモート 制御を有効にする必要があります。 セッション同期の詳細については、 セッション データ GitHub Copilot CLI について を参照してください。

前提条件

  • CLI セッションが実行されているマシンはオンラインであり、セッションはターミナルでアクティブに実行されている必要があります。

    ヒント

    /keep-aliveスラッシュ コマンドを使用して、外出中にマシンがスリープ状態にならないようにします。 「 コンピューターがスリープ状態にならないようにする」を参照してください。

  • リモート コントロールでは、 GitHub.comでホストされている Git リポジトリは必要ありません。 リモート 制御は、複数のリポジトリを含む親ディレクトリを含む Git リポジトリ以外のディレクトリや、 GitHub.com以外の場所でホストされているリポジトリから有効にすることができます。 GitHub リポジトリの外部で開始されたセッションは、任意のリポジトリ ("リポジトリなし") と関連付けられていない状態で表示され、github.com/copilot/agents のエージェント ページにのみ表示されます。 GitHub リポジトリ内で開始されたセッションは、そのリポジトリの [エージェント] タブにも表示されます。

    場合によっては、Git リモートが構成されていてもアクセスできない場合など、作業ディレクトリのリポジトリを解決できない場合があります。 これが発生すると、リモート コントロールが無効になり、CLI に "リモート セッションが無効になっています" というメッセージが表示されます。

セッションのリモート 制御を有効にする

リモート コントロールは、いくつかの方法で有効にすることができます。

  • 対話型セッションの途中でスラッシュコマンドを使用します。
  • Copilot CLIを開始するとき、コマンドラインオプションを使用します。
  • すべての対話型セッションで既定でリモート 制御を有効にするように CLI を構成する。
  • セッションを開始する前に、JetBrains IDE の設定から。

/remoteスラッシュ コマンドの使用

既に対話型セッションに参加していて、リモート コントロールを有効にする場合は、次のように入力します。

Copilot prompt
/remote on

CLI はGitHub.comに接続し、セッションにリモートでアクセスするための詳細を表示します。この記事の後半の「GitHub.comからのセッションへのアクセス」と「GitHub Mobileからのセッションへのアクセス」を参照してください。

/remoteスラッシュ コマンドを引数なしで使用して、現在のリモート コントロールの状態を確認したり、リモート コントロールが現在有効になっている場合はリモート アクセスの詳細を再表示したりできます。 現在のセッションのリモート接続を終了する場合は、「 /remote off」と入力します。

--remote コマンド ライン オプションの使用

セッションにリモートでアクセスしたい場合は、 --remote コマンド ライン オプションを使用して CLI を開始できます。 これにより、セッション中に /remote スラッシュ コマンドを忘れずに使用する必要がなくなります。

Bash
copilot --remote

セッションにリモートでアクセスするための詳細は、対話型セッションの開始時に表示され、 /remote スラッシュ コマンドを使用していつでも再び表示できます。

常に有効にするようにリモート コントロールを構成する

対話型 CLI セッションに常にリモートからアクセスできるようにする場合は、 Copilot 設定ファイル (通常は ~/.copilot/settings.json にあります) に次を追加します。

JSON
{
  "remoteSessions": true
}

特定のセッションに対してこの設定をオーバーライドするには、セッションの開始時に --no-remote オプションを使用します。

Bash
copilot --no-remote

メモ

コマンド ライン オプションの --remote と --no-remote は、常に設定ファイルの remote 設定よりも優先されます。

JetBrains IDE 設定の使用

JetBrains IDE から Copilot CLI を使用する場合は、セッションを開始する前に IDE からリモート 制御を有効にすることができます。

  1. JetBrains IDE で、ファイル メニュー (Windows) またはメニュー バー (macOS) のアプリケーションの名前をクリックし、設定 をクリックします。

  2. 左側のサイドバーで[ツール]をクリックし、[GitHub Copilot]をクリックします。をクリックし、[ チャット] をクリックします。

  3. Enable Copilot CLI Remote を選択します。

  4. IDE から対話型の Copilot CLI セッションを開始します。

この設定を有効にすると、セッションの /remote をいつでも使用して、現在のリモート コントロールの状態を表示したり、セッションにリモートでアクセスするためのリンクと QR コードを再表示したりできます。

からセッションにアクセスする GitHub.com

リモート 制御を有効にすると、CLI によってセッションへのリンクが GitHub.comに表示されます。

リンクを使用して、既定の Web ブラウザーでセッションにアクセスします。 CLI セッションを開始したのと同じアカウントで GitHub にサインインする必要があります。

リンクなしでセッションにアクセスすることもできます。

  1. 任意のコンピューターで GitHub.com にログオンします。

  2. GitHubの左上隅にある [] をクリックします。

  3. [ Copilot] をクリックします。

    CLI セッションが [最近使用したエージェント セッション] の下に一覧表示されます。

  4. 必要に応じて、リストの右上にある [種類 ] フィルターを使用して、 Copilot CLI セッションのみを表示します。

  5. Copilot CLI セッションを開くにはクリックしてください。

GitHub リポジトリのローカル コピーからセッションを開始した場合は、**** のそのリポジトリの [GitHub.com] タブからセッションにアクセスすることもできます。

重要

リモートからアクセスできるセッションはユーザー固有です。独自の Copilot CLI セッションにのみアクセスできます。 他の GitHub ユーザーはセッションにアクセスできません。

からセッションにアクセスする GitHub Mobile

Copilot CLI セッションは、リモート コントロールを有効にするとすぐにGitHub Mobileで使用できます。 GitHub Mobileでセッションを検索するには:

  1. 画面の右下隅にある [ Copilot ] ボタンをタップします。

    セッションが [エージェント セッション] の下に表示されます。

  2. セッションをタップして開きます。

QR コードを使用して電話でセッションをすばやく開く

  1. 対話型セッションで、 /remote スラッシュ コマンドを入力して、リモート セッションの詳細を再表示します。

  2. Ctrl+キーを押して、QR コードの表示/非表示を切り替えます。

    メモ

    このキーボード ショートカットは、QR コードだけでなく、セッション会話のすべての詳細を展開または折りたたみします。 これは、入力フィールドが現在空の場合にのみ機能します。

  3. 電話で QR コードをスキャンして、 GitHub Mobileのセッションに直接移動します。

コンピューターがスリープ状態にならないようにする

/keep-aliveスラッシュ コマンドを使用して、コンピューターがスリープ状態にならないようにすることができます。 これにより、リモート接続を維持し、 GitHub.com または GitHub Mobileからセッションとの対話を続行できます。

対話型セッションで、「 /keep-alive OPTION」と入力します。ここで、 OPTION は次のいずれかになります。

  • on: CLI セッションがアクティブな間にマシンがスリープ状態にならないようにします。
  • off: コンピューターが通常どおりにスリープ状態になります。
  • busy: Copilot がタスクで作業している間だけマシンがスリープ状態にならないようにします。 エージェントがタスクを完了すると、マシンは通常どおりにスリープ状態になります。 Copilotがユーザーからの入力要求に応答するのを待機している場合、マシンはスリープ状態になりません。
  • NUMBERm、 NUMBERh、または NUMBERd (たとえば、 30m、 8h、 1d): コンピューターが特定の分、時間、または日の間スリープ状態にならないようにします。 サフィックスなしの数値を指定すると、分として扱われます。

OPTIONを渡さずに、/keep-alive コマンドは現在のキープアライブ状態を表示します。

以前のセッションの確認

Copilot CLIまたはGitHub.comで、古いGitHub Mobile セッションを表示できます。

  1. GitHub.comまたは GitHub Mobile で最近使用したエージェント セッションの一覧に移動します。 &

lt;c0>github.com</c0>からのセッションへのアクセスと<c1>GitHub Mobile</c1>からのセッションへのアクセスについては、この記事の以前のセクションを参照してください。

  1. 確認するセッションをクリックまたはタップします。

GitHub.comでは、セッションを再開する場合に使用する copilot --resume コマンドがメッセージに表示されます。 セッションを実行したコンピューターのターミナルで、このコマンドを入力します。

セッションの再開

copilot --continueまたはcopilot --resumeを使用して、リモート コントロールが有効になっている CLI セッションを再開すると、リモート コントロールが自動的に再び有効になります。

リモート コントロールの防止

リモート コントロールは既定では無効になっていますが、 Copilot 設定ファイル (通常は ~/.copilot/settings.json) で有効にできます。 セッションがリモートで制御できないようにするには、次の方法があります。

  • 1 つのセッションの場合: 設定ファイルの値に関係なく、 --no-remote を使用して CLI を開始し、そのセッションのリモート 制御を防止します。
  • 永続的:"remoteSessions": trueから~/.copilot/settings.json設定を削除するか、falseに設定します。

エンタープライズ所有者は、個人設定に関係なく、エンタープライズ管理設定を使用して、デバイスでホストされているセッションのリモート 制御を制限することもできます。 構成されたポリシーによっては、デバイス上のセッションのリモート 制御が完全に無効になっているか、特定の組織に対して SSO が承認された制御クライアントのみが使用できます。 これは、他のデバイスでホストされている独自のセッションをリモートで制御する機能には影響しません。 「エンタープライズ管理設定」を参照してください。

詳細については、次を参照してください。