リモート アクセスを使用すると、任意のブラウザーまたはCopilot CLIから実行中のGitHub Mobile セッションに接続できます。 セッションの出力を表示し、アクセス許可要求に応答し、セッションが実行されているマシンにいない状態でセッションで作業を続けることができます。
この記事では、リモート アクセスを有効にして使用する方法について説明します。 概念の詳細については、「 AUTOTITLE」を参照してください。
メモ
* Copilot CLI セッションへのリモート アクセスはパブリック プレビューであり、変更される可能性があります。
- モバイル アクセスは現在、 GitHub Mobileの最新ベータ リリースでのみ利用できます。 GitHub Mobile と Android 用 Google Play を使用して、のテスト プログラムに参加できます。
前提条件
-
CLI セッションが実行されているマシンはオンラインであり、セッションはターミナルでアクティブに実行されている必要があります。
ヒント
`/keep-alive`スラッシュ コマンドを使用して、外出中にマシンがスリープ状態にならないようにします。 「 [コンピューターがスリープ状態にならないようにする」を参照してください](#preventing-your-machine-from-going-to-sleep)。 -
作業ディレクトリには、 GitHub.comでホストされている Git リポジトリが含まれている必要があります。 GitHub リポジトリにいない場合は、CLI に "リモート セッションが無効: GitHub リポジトリにありません" と表示されます。
セッションのリモート アクセスを有効にする
リモート アクセスは、次の 3 つの方法で有効にすることができます。
- 対話型セッションの途中でスラッシュコマンドを使用します。
-
Copilot CLIを開始するとき、コマンドラインオプションを使用します。 - すべての対話型セッションで既定でリモート アクセスを有効にするように CLI を構成する。
`/remote`スラッシュ コマンドの使用
既に対話型セッションに参加していて、リモート アクセスを有効にする場合は、次のように入力します。
/remote
/remote
CLI はGitHub.comに接続し、セッションにリモートでアクセスするための詳細を表示します。この記事の後半の「GitHub.comからのセッションへのアクセス」と「GitHub Mobileからのセッションへのアクセス」を参照してください。
`--remote` コマンド ライン オプションの使用
セッションにリモートでアクセスしたい場合は、 --remote コマンド ライン オプションを使用して CLI を開始できます。 これにより、セッション中に /remote スラッシュ コマンドを忘れずに使用する必要がなくなります。
copilot --remote
copilot --remote
セッションにリモートでアクセスするための詳細は、対話型セッションの開始時に表示され、 /remote スラッシュ コマンドを使用していつでも再び表示できます。
常に有効にするためのリモート アクセスの構成
対話型 CLI セッションに常にリモートからアクセスできるようにする場合は、 Copilot 構成ファイル (通常は ~/.copilot/config.json にあります) に次を追加します。
{
"remoteSessions": true
}
{
"remoteSessions": true
}
特定のセッションに対してこの設定をオーバーライドするには、セッションの開始時に --no-remote オプションを使用します。
copilot --no-remote
copilot --no-remote
メモ
コマンド ライン オプション --remote と --no-remote は、常に構成ファイルの remoteSessions 設定よりも優先されます。
からセッションにアクセスする GitHub.com
リモート アクセスが有効になっている場合、CLI は次の形式でリンクを表示します。
https://github.com/OWNER/REPO/tasks/TASK_ID
このリンクを使用して、Web ブラウザーでセッションにアクセスします。 CLI セッションを開始したのと同じアカウントで GitHub にサインインする必要があります。
GitHub.comの最近のエージェント セッションの一覧からセッションにアクセスすることもできます。
1. GitHubの左上隅にある [] をクリックします。
- [ Copilot] をクリックします。
- [最近使用したエージェント セッション] で、 Copilot CLI セッションをクリックして開きます。
重要
セッションはユーザー固有です。独自の Copilot CLI セッションにのみアクセスできます。 他の GitHub ユーザーはセッションにアクセスできません。
からセッションにアクセスする GitHub Mobile
Copilot CLI セッションは、リモート アクセスを有効にするとすぐにGitHub Mobileで使用できます。
GitHub Mobileでセッションを検索するには:
-
画面の右下隅にある [ Copilot ] ボタンをタップします。
セッションが [エージェント セッション] の下に表示されます。
-
セッションをタップして開きます。
QR コードを使用して電話でセッションをすばやく開く
-
対話型セッションで、
/remoteスラッシュ コマンドを入力して、リモート セッションの詳細を再表示します。 -
Ctrl+キーを押して、QR コードの表示/非表示を切り替えます。
メモ
このキーボード ショートカットは、QR コードだけでなく、セッション会話のすべての詳細を展開または折りたたみします。 これは、入力フィールドが現在空の場合にのみ機能します。
-
電話で 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` コマンドは現在のキープアライブ状態を表示します。
リモート アクセスを使用したセッションの再開
リモート アクセスが有効になっているセッションをシャットダウンすると、CLI によって、 --remoteを含む再開コマンドが表示されます。
copilot --resume=SESSION_ID --remote
このコマンドを使用して、リモート アクセスを有効にしてセッションを再起動します。
同様に、--remote コマンドにcopilot --continueを追加すると、リモート アクセスが有効になっている最新のセッションが再開されます。
`"remoteSessions": true`構成ファイルにCopilotがある場合、再開されたセッションではリモート アクセスが自動的に有効になり、`--remote` オプションを使用する必要はありません。
リモート アクセスの防止
リモート アクセスは既定では無効になっていますが、 Copilot 構成ファイルで有効になっている可能性があります。 次の方法でセッションにリモートでアクセスできないようにすることができます。
-
**1 つのセッションの場合**: 構成ファイルの設定に関係なく、 `--no-remote` を使用して CLI を開始し、そのセッションのリモート アクセスを禁止します。 -
**永続的:**`"remoteSessions": true`構成ファイルからCopilot設定を削除します (または、`false`に設定します)。