GITHUB COPILOT CLI コマンド リファレンス

コマンドラインコマンド

copilot login のオプション

ローカル ターミナル、またはブラウザーにまだ到達できる TTY 以外のローカル プロセス (ディスプレイまたはブラウザー信号を含むデスクトップ OS、Linux など) では、既定の認証モードはブラウザーベースの Web フローです。CLI はブラウザーを開いて承認し、ローカル ループバック コールバックで結果をキャプチャします。 リモート ターミナル (SSH、 GitHub Codespaces、開発コンテナーなど) または CI では、ブラウザーが通常ループバック ポートに到達できないため、CLI は既定で OAuth デバイス コード フローに設定されます。 --web-flowまたは--device-codeを使用して、自動的に選択されたフローをオーバーライドします。

完了後、認証トークンはシステム資格情報ストアに安全に格納されます。 資格情報ストアが見つからない場合、トークンは、 ~/.copilot/ (または設定されている場合は COPILOT_HOME によって指定されたディレクトリ) の下のプレーン テキスト構成ファイルに格納されます。

または、 Copilot CLI (コパイロット CLI) は環境変数に含まれる認証トークンを使用します。 COPILOT_GITHUB_TOKEN、GH_TOKEN、GITHUB_TOKENの順にチェックされます。 この方法は、自動化などのヘッドレス使用に最適です。

サポートされているトークンの種類には、"Copilot Requests" アクセス許可を持つ fine-grained personal access tokens (v2 PAT)、 Copilot CLI アプリからの OAuth トークン、 GitHub CLI (gh) アプリからの OAuth トークンが含まれます。 クラシック personal access tokens (ghp_) はサポートされていません。

例:

# Authenticate with github.com
copilot login

# Authenticate with GitHub Enterprise Cloud (data residency)
copilot login --host https://example.ghe.com

# Force the device code flow, for example on a remote terminal
copilot login --device-code

# Force the browser (web) flow, for example on a local terminal
copilot login --web-flow

# Use a fine-grained PAT via environment variable
COPILOT_GITHUB_TOKEN=github_pat_... copilot

copilot completion の使用

コマンド copilot completion SHELL は、指定されたシェル (bash、zsh、または fish) のスクリプトを出力します。

このスクリプトを利用する (またはシェルの補完ディレクトリに書き込む) と、copilot のサブコマンド、コマンドオプション、コマンドオプションの既知の値を選択する際のターミナルでのタブ補完を有効にすることができます。

使用例

Bash (現在のセッションのみ):

source <(copilot completion bash)

source <(copilot completion bash)

Bash (永続的、Linux):

copilot completion bash | sudo tee /etc/bash_completion.d/copilot

copilot completion bash | sudo tee /etc/bash_completion.d/copilot

Zsh — $fpathのディレクトリに出力を書き込みます。 次のコマンドを実行した後、シェルを再起動します。

copilot completion zsh > "${fpath[1]}/_copilot"

copilot completion zsh > "${fpath[1]}/_copilot"

魚：

copilot completion fish > ~/.config/fish/completions/copilot.fish

copilot completion fish > ~/.config/fish/completions/copilot.fish

copilot plugins list の使用

copilot plugins listを実行して、現在の作業ディレクトリで検出されたすべてのプラグイン、MCP サーバー、スキル、命令ソース、言語サーバーを検査します。 出力は、種類、構成スコープ (ユーザー、リポジトリ、組織、プラグイン提供、組み込み、不明) ごとにグループ化されます。

# List everything for the current workspace
copilot plugins list

# Only MCP servers and skills
copilot plugins list --kind mcp --kind skill

# Only user-scoped resources, as JSON
copilot plugins list --scope user --json

カスタム エージェントとセッション スコープのフックは、 copilot plugins listの対象になりません。両方ともライブ セッションが必要です。

copilot plugins enable / copilot plugins disable

プラグイン、MCP サーバー、またはスキルを名前で有効または無効にします。 変更は構成に保持され、今後のセッションに適用されます。

# Disable an MCP server
copilot plugins disable github --mcp

# Enable a skill
copilot plugins enable my-skill --skill

# Enable a plugin (default kind)
copilot plugins enable spark@copilot-plugins

指示はセッション内でのみ有効であり、これらのコマンドで切り替えることはできません。 言語サーバー、エージェント、フックは他の場所で管理されます。

copilot plugins remove

プラグインをアンインストールするか、MCP サーバーを削除するか、スキルを名前で削除します。

# Remove an MCP server
copilot plugins remove github --mcp

# Delete a personal or project skill
copilot plugins remove my-skill --skill

# Uninstall a plugin (default kind)
copilot plugins remove spark@copilot-plugins

--skillでは、スキル名または追加したカスタム スキル ディレクトリへのパスを渡します。 スキル名は、そのスキルのファイルを削除します。カスタム ディレクトリ パスは、ディレクトリの登録を解除し、そのファイルをディスク上に残すだけです。 追加した個人およびプロジェクトのスキルのみを削除できます。プラグインまたは組み込みセットによって提供されるスキルは、この方法では削除できません (代わりに無効にします)。 命令ソースはディスクから検出され、ここで削除することはできません。

対話型インターフェイスのグローバル ショートカット

ローカル セッションでは、プロンプト、シェル コマンド、およびサポートされているスラッシュ コマンドをキューに入れ、現在のタスクの完了後に順番に実行できます。

• キーを押して、エージェントの実行中に現在の入力をキューに入れます。 キューに登録されたエントリには "保留中" のラベルが表示され、実行前に個別に取り消すことができます。

対話型インターフェイスのタイムライン ショートカット

セッション ピッカーのショートカット

セッション ピッカーが開いている場合 ( /resume または --continueを使用して開きます)。

セッションは、次のモードで並べ替えられます。

セッションは既に別のウィンドウで開かれているので、関連性のないすべての並べ替えモードで一番上に浮動します。 作業ディレクトリ コンテキストが使用できない場合、 relevance モードはスキップされます。

差分モードのショートカット

差分モードが開いている場合 ( /diff経由で入力):

対話型インターフェイスのナビゲーション ショートカット

対話型インターフェース内のスラッシュコマンド

これらは、対話型 CLI セッション内から使用できるスラッシュ コマンドです。 これらのスラッシュ コマンドのサブセットは、ACP サーバー経由で CLI を使用するクライアントで使用できます。 詳細については、「Copilot CLI ACP サーバー」を参照してください。

使用可能なスラッシュ コマンドの完全な一覧については、CLI の対話型インターフェイスに「 /help 」と入力します。

コマンド ライン オプション

コマンドとオプションの完全な一覧については、 copilot helpを実行します。

--remoteと--resume <TASK-ID>を使用して、リモート タスクをローカルで再開できます。 これは、タスクが最初に Git リポジトリの外部で作成された場合でも機能します。

allow-all オプションの制限

permissions.disableBypassPermissionsModeが "disable" に設定されている場合、すべてのアクセス許可 (--allow-all-tools、--allow-all-paths、--allow-all-urls、--allow-all、--yolo) を許可するすべてのコマンド ライン オプションは起動時に抑制され、昇格されたアクセス許可を付与するために使用することはできません。 /permissions allow-allスラッシュ コマンドとそのエイリアス/allow-allおよび/yoloも抑制されます。

この制限は、次の 3 つのソースで設定できます。この制限は、永続性の順に増加します。

MDM 構成の詳細については、 GitHub Copilot CLI の構成ディレクトリ を参照してください。

サポートされているモデル

--model=MODELまたはCOPILOT_MODEL環境変数を使用して、AI モデルを選択します。 autoを渡して、使用可能な最適なモデルCopilot自動的に選択できるようにします。

/modelスラッシュ コマンドを使用して、対話型セッション中にモデルを切り替えることもできます。

ツールの可用性の値

--available-toolsと--excluded-toolsのオプションでは、次の値がサポートされます。

シェル ツール

ファイル操作ツール

エージェントとタスクの委任ツール

その他のツール

ツールのアクセス許可パターン

--allow-toolオプションと--deny-toolオプションは、Kind(argument)形式のアクセス許可パターンを受け入れます。 引数は省略可能です。省略すると、その種類のすべてのツールと一致します。

shellルールの場合、:*サフィックスはコマンド ステムと一致し、その後にスペースが続き、部分的な一致が防止されます。 たとえば、 shell(git:*) は git push と git pull に一致しますが、 giteaと一致しません。

拒否規則は、 --allow-all が設定されている場合でも、許可規則よりも常に優先されます。

# Allow all git commands except git push
copilot --allow-tool='shell(git:*)' --deny-tool='shell(git push)'

# Allow a specific MCP server tool
copilot --allow-tool='MyMCP(create_issue)'

# Allow all tools from a server
copilot --allow-tool='MyMCP'

# Deny writes to a specific path (exact or trailing-path-segment match; no glob support yet)
copilot --deny-tool='write(secret.txt)'

--deny-tool='write(PATH)' は拒否の適用範囲をそのパスに限定します。他の書き込みには影響しません。 この一致により、シンボリック リンクと./.. セグメントが解決され、macOS とWindowsでは大文字と小文字が区別されません。

環境変数

構成ファイルの設定

構成ファイルの設定の詳細については、ユーザー設定、リポジトリ設定、ローカル設定の完全な一覧、それらがカスケードされる方法など、 GitHub Copilot CLI の構成ディレクトリ を参照してください。

Copilot のプロジェクト初期化

対話型セッション内でコマンド copilot initまたはスラッシュ コマンド /init を使用すると、 Copilot はコードベースを分析し、リポジトリ内の .github/copilot-instructions.md ファイルを書き込みまたは更新します。 このカスタム命令ファイルには、将来の CLI セッションを改善するプロジェクト固有のガイダンスが含まれています。

通常は、新しいプロジェクトを開始するとき、または既存のリポジトリでcopilot initの使用を開始するときに、/initまたはCopilot CLI (コパイロット CLI)を使用します。

通常、作成または更新された copilot-instructions.md ファイルは、次のドキュメントを作成または更新します。

• Build、test、lint コマンド
• ハイレベルアーキテクチャ
• コードベース固有の規則。

ファイルが既に存在する場合、 Copilot は、適用または拒否を選択できる機能強化を提案します。

CLI は起動時に copilot-instructions.md ファイルを検索し、見つからない場合はメッセージを表示します。

💡 副操縦命令が見つかりませんでした。 /init を実行して、このプロジェクトの copilot-instructions.md ファイルを生成します。

このファイルを作成しない場合は、 /init suppress スラッシュ コマンドを使用して、現在のリポジトリのこのスタートアップ メッセージを完全に非表示にすることができます。

詳細については、「GitHub Copilot用のリポジトリカスタム命令の追加」を参照してください。

カスタム命令の場所

Copilot CLI (コパイロット CLI) これらの場所からカスタム命令を同時に読み込みます (すべてがマージされます)。

カスタム命令のインポート

命令ファイルでは、 @path インポートがサポートされます。 @を含む行の前に、別のファイルの内容をインライン化するためのパスを付けます。 パスは、命令ファイルのディレクトリまたは絶対パスに対する相対パスにすることができます。 インポートは、サイクルとサイズのガードを使用して、深さの制限まで再帰的に解決されます。 これは、 AGENTS.md、 CLAUDE.md、および .github/copilot-instructions.mdでサポートされています。

フック リファレンス

フックの構成形式、フック イベント、入力ペイロード、決定制御など、フックの詳細については 、AUTOTITLE を参照してください。

MCP サーバーの構成

MCP サーバーは、CLI エージェントに追加のツールを提供します。 ~/.copilot/mcp-config.jsonで永続的なサーバーを構成します。 --additional-mcp-configを使用して、1 つのセッションのサーバーを追加します。

サンドボックス内で生成されるローカル (stdio) サーバー (/sandbox スラッシュ コマンドを参照) では、リモート (HTTP/SSE) サーバーはサンドボックス化されないので、connected (sandboxed)とcopilot mcp listで/mcp list状態が表示されます。 実験モードでのみ使用できます。

copilot mcp list と /mcp list は、無効なサーバーを、テキスト出力では (disabled) サフィックスを付けて、または "enabled": false 出力ではサーバーごとに --json を付けてマークします。 copilot mcp get には、 Status: Enabled/Disabled 行が表示されます。

/sandbox を切り替えると、サンドボックス内で起動されるため、ローカル（stdio）の MCP サーバーだけが再起動されます。 リモート (HTTP/SSE) サーバーは接続された状態を維持します。

copilot mcp サブコマンド

copilot mcpを使用して、対話型セッションを開始せずにコマンド ラインから MCP サーバー構成を管理します。

ローカル (stdio) サーバーの場合は、 --後にコマンドを指定します。

copilot mcp add SERVER-NAME -- COMMAND [ARGS...]

copilot mcp add SERVER-NAME -- COMMAND [ARGS...]

リモート HTTP または SSE サーバーの場合は、トランスポートを指定し、URL を指定します。

copilot mcp add --transport http SERVER-NAME URL

copilot mcp add --transport http SERVER-NAME URL

** copilot mcp add オプション：**

/mcp add / /mcp edit対話型フォームで、envフィールドをコンマ区切りのKEY=VALUEペアまたは JSON オブジェクト ({"API_KEY":"secret"} など) として入力します。 $PATH は既定で含まれており、一覧表示する必要はありません。

トランスポートの種類

ローカル サーバー構成フィールド

ツール スナップショットキャッシュ

Copilot CLI (コパイロット CLI) では、各ローカル サーバーのツール リストのスナップショットが保持されるため、ライブ検出がバックグラウンドで完了している間は、起動時にすぐにツールを使用できます。 ライブ検出は常に実行され、完了するとスナップショットが置き換えられます。

サーバーで disableToolCache: true を設定して、そのサーバーに対してのみライブ検出を強制するか、 COPILOT_MCP_TOOL_CACHE=false 環境変数を設定して、プロセス全体のスナップショットの読み込みと永続化を無効にします。 どちらのオプトアウトも、既存のキャッシュ ファイルはそのまま残ります。

プライベート npm レジストリ

--registry配列のargsを使用して、Artifactory や GitHub Packages フィードなどのプライベート npm レジストリからパッケージをプルします。

{
    "mcpServers": {
        "my-internal-server": {
            "command": "npx",
            "args": [
                "--registry", "https://npm.pkg.github.com",
                "@my-org/internal-mcp-server"
            ],
            "tools": ["*"]
        }
    }
}

--registry フラグとその他の npm 構成フラグ (--userconfig、--globalconfig、--prefix、--cache、--node-options、--workspace、-w) は、サーバーの ID フィンガープリントを計算するときに値を消費する引数として扱われます。 これにより、パッケージ名の前にこれらのフラグが表示される場合に、エンタープライズ許可リストのチェックとレジストリ検証が正しく機能します。

リモート サーバー構成フィールド

OAuth 再認証

OAuth を使用するリモート MCP サーバーでは、トークンの有効期限が切れたとき、または別のアカウントが必要な場合に、 needs-auth 状態が表示される場合があります。 /mcp auth <server-name>を使用して、新しい OAuth フローをトリガーします。 ブラウザー認証プロンプトが開き、サインインまたはアカウントの切り替えが可能になります。 フローが完了すると、サーバーは自動的に再接続します。

ヘッドレス OAuth (client_credentials 許可)

ブラウザーが使用できない CI または cron のユース ケースでは、 oauthGrantType: "client_credentials"設定します。 これには、次のことが必要です。

• oauthClientId—MCP プロバイダーによって発行された静的クライアント ID。
• oauthPublicClient: false—クライアントは機密です。
• client_secretシステム キーチェーンに格納されます (/mcp UI または OAuth 資格情報ストアへの書き込みによって 1 回構成されます)。

構成すると、CLI はブラウザー、コールバック サーバー、PKCE、動的クライアント登録を完全にスキップします。 401 ごとに、 grant_type=client_credentials がサーバーの検出されたトークン エンドポイントに直接投稿されます。

{
    "mcpServers": {
        "headless-api": {
            "type": "http",
            "url": "https://api.example.com/mcp",
            "tools": ["*"],
            "oauthClientId": "YOUR-CLIENT-ID",
            "oauthPublicClient": false,
            "oauthGrantType": "client_credentials"
        }
    }
}

フィルター マッピング

サーバーの構成の filterMapping フィールドを使用して、MCP ツールの出力を処理する方法を制御します。

組み込みの MCP サーバー

CLI には、追加のセットアップなしで使用できる組み込みの MCP サーバーが含まれています。

--disable-builtin-mcpsを使用してすべての組み込みサーバーを無効にするか、--disable-mcp-server SERVER-NAMEを使用して特定のサーバーを無効にします。

GitHub MCP サーバー ツール

github-mcp-serverには、次のツールが用意されています。

MCP サーバーの名前付け

サーバー名には、スペース、Unicode 文字、句読点など、印刷可能な任意の文字を含めることができます。 制御文字 (U+0000 – U+001F, U+007F) および右中括弧 (}) は使用できません。 サーバー名は、ツール名のプレフィックスとして使用されます。たとえば、 my-server という名前のサーバーは my-server-fetchなどのツール名を生成し、 My Server という名前のサーバーは My Server-fetchを生成します。

MCP ツール名のサニタイズ

MCP サーバー名とツール名は、モデルに送信される前にサニタイズされます。 ツール名で無効な文字 ( a-z、 A-Z、 0-9、 -、 _以外の文字) は、 -に置き換えられます。 Unicode 文字は Punycode でエンコードされます。 また、 @ シンボルは、Punycode エンコードとの競合を回避するために、 - に置き換えられます。

結合名 (serverName-toolName) の上限は 64 文字です。 切り捨てによって名前の競合が発生する場合は、一意性を確保するために数値サフィックス (たとえば、 my-server-tool2、 my-server-tool3) が追加されます。

MCP サーバーの信頼レベル

MCP サーバーは、それぞれ異なる信頼レベルを持つ複数のソースから読み込まれます。

すべての MCP ツールの呼び出しには、明示的なアクセス許可が必要です。 これは、外部サービスの読み取り専用操作にも適用されます。

MCP サーバーの読み込み優先度

異なるソースの MCP サーバーは、優先順位 (最も高い順) でマージされます。 サーバーが名前を共有する場合、優先順位の高いソースが優先されます。

1. --additional-mcp-config フラグ (最高)
2. プラグインによって提供されるサーバー
3. ワークスペース サーバー—.mcp.json と .github/mcp.json は作業ディレクトリから Git ルートに向かって上位へたどりながら読み込まれます。フォルダーが信頼済みである必要があります
4. ~/.copilot/mcp-config.json (最低)

Enterprise MCP 許可リスト

GitHub Enterprise 組織は、 許可された MCP サーバーの許可リストを強制できます。 アクティブな場合、CLI は、接続する前に、既定以外の各サーバーをエンタープライズ ポリシーに照らして評価します。

GitHub Enterprise レジストリ ポリシーが検出された場合 (または、MCP_ENTERPRISE_ALLOWLIST試験的機能フラグが有効になっている場合)、CLI は次の手順を実行します。

1. コマンド、引数、およびリモート URL に基づいて、構成された既定以外のサーバーごとにフィンガープリントを計算します。
2. エンタープライズ許可リスト評価エンドポイントに指紋を送信します。
3. 指紋が承認されているサーバーのみを許可します。それ以外はすべて、エンタープライズに名前を付けるメッセージでブロックされます。

このチェックは失敗します。評価エンドポイントに到達できない場合、またはエラーが返された場合、ポリシーを検証できるようになるまで、既定以外のサーバーはブロックされます。

サーバーがエンタープライズ許可リストによってブロックされると、CLI には次の情報が表示されます。

MCP server "SERVER-NAME" was blocked by your enterprise "ENTERPRISE-NAME".
Contact your enterprise administrator to add this server to the allowlist.

組み込みの既定のサーバーは、常に許可リストの適用から除外されます。

からの移行 .vscode/mcp.json

プロジェクトで.vscode/mcp.json (VS Code の MCP 構成形式) を使用している場合は、.mcp.jsonに対応するためにGitHub Copilot CLI（コマンドラインインターフェース）へ移行してください。 移行により、 servers キーが mcpServersに再マップされます。

POSIX シェル (bash、zsh、fish など):

jq '{mcpServers: .servers}' .vscode/mcp.json > .mcp.json

jq が必要です。

PowerShell:

pwsh -NoProfile -Command "`$json = Get-Content '.vscode/mcp.json' -Raw | ConvertFrom-Json; `$content = ([pscustomobject]@{ mcpServers = `$json.servers } | ConvertTo-Json -Depth 100); [System.IO.File]::WriteAllText('.mcp.json', `$content, (New-Object System.Text.UTF8Encoding `$false))"

Windowsで、PowerShell Core の代わりに Windows PowerShell を使用している場合は、pwsh を powershell に置き換えます。

Stdio サーバーの出力

MCP stdio トランスポートは、改行区切りの JSON-RPC フレーム専用に stdout を予約します。 CLI は、出力をプロトコル パーサーに渡す前に、JSON 以外の行 (プレーンテキスト ログ、例外スタック トレース、または空白のみの行) を自動的に除外します。

stdout ではなく、すべての診断出力を stderr に書き込みます。 stdout にログまたはエラー メッセージを書き込むサーバーは、初期化ハンドシェイクをストールさせる解析エラー フィードバック ループをトリガーできます。このフィルターは、JSON 以外のフレームをサイレント に削除することでこれを防ぎます。

1 MB を超える行は構造チェックをバイパスし、as-is転送されます。これは、サイズが大きいが有効なプロトコル フレーム (大きな tools/list 応答など) の分割やドロップを回避するためです。

スキルのリファレンス

スキルは、CLI で実行できる機能を拡張する Markdown ファイルです。 各スキルは、 SKILL.md ファイルを含む独自のディレクトリに存在します。 ( /SKILL-NAME 経由で、またはエージェントによって自動的に) 呼び出されると、スキルのコンテンツが会話に挿入されます。

スキルのフロントマター フィールド

スキルの場所

スキルは、これらの場所から優先順位に従って読み込まれます（名前が重複した場合は、最初に見つかったものが使用されます）。

リモート スキルは、ローカル スキルと共に投影され、ローカル スキルの名前が同じである場合は、同じ名前ベースの優先順位に従います。

2 つのプラグインが同じ名前のスキルを提供する場合、 /my-plugin/search や /other-plugin/searchなどのプラグイン修飾呼び出し名を使用して共存します。 修飾なしの名前は、優先度の高いプラグインに振り分けられます。 これはスキルにのみ適用されます。コマンドは、優先順位の高いソースが優先される Standard レベルベースの重複除去を維持します。

非対話形式でのスキルのインストール

copilot plugins install --skillを使用して、対話型セッションを開かずにファイル、URL、またはディレクトリからスキルをインストールします。

# Install for your user account (default scope)
copilot plugins install --skill ./my-skill/SKILL.md

# Install into the current project (.github/skills; file or URL skills only)
copilot plugins install --skill --scope project ./my-skill/SKILL.md

ディレクトリをインストールすると、コピーするのではなく、カスタム スキル ソースとして登録されます。 ファイルまたは URL をインストールすると、スキルのコンテンツが個人またはプロジェクトのスキル ディレクトリにコピーされます。 同等の対話型コマンドが /plugins install --skill [--project] <FILE|URL|DIRECTORY>。 完全なオプション リファレンスについては、 AUTOTITLE を参照してください。

コマンド (代替スキル形式)

コマンドは、.mdに個々の.claude/commands/ ファイルとして格納されるスキルの代わりに使用できます。 コマンド名はファイル名から派生します。 コマンド ファイルは簡略化された形式 ( name フィールドは不要) を使用し、 argument-hint、 description、 allowed-tools、および disable-model-invocationをサポートします。 コマンドの優先順位は、同じ名前のスキルよりも低くなります。

カスタム エージェント リファレンス

カスタム エージェントは、Markdown ファイルで定義されている特殊な AI エージェントです。 ファイル名 (拡張子を引いた値) がエージェント ID になります。 ファイル拡張子として .agent.md または .md を使用します。

組み込みエージェント

カスタムエージェントのフロントマター フィールド

カスタム エージェントの場所

プロジェクト スコープのエージェントの場合、CLI は現在の作業ディレクトリから Git ルートに上向きに移動し、各先祖レベルで .github/agents/ および .claude/agents/ ディレクトリを読み込みます。 つまり、monorepo 内の各パッケージまたはサブディレクトリは、独自のエージェントを提供できます。 パスに複数の .github/agents/ ディレクトリが存在する場合は、最も深いディレクトリが最も高い優先順位で、すべてが読み込まれます。 .github/agents/規則は、同じレベルの.claude/agents/よりも優先されます。 ユーザー レベルのエージェントの優先度は、プロジェクト レベルのエージェントよりも低くなります。 プラグイン エージェントの優先度は最も低くなります。

エージェント通信

カスタム エージェント内で list_agents と write_agent を使用して、近くのエージェントを検査し、マルチエージェント セッションで作業を調整します。

list_agents の関係ラベル

関係ラベルは、可視エージェントと現在のエージェントの関係を識別します。 共有兄弟通信が有効になっている親セッション内でサブエージェントが実行されると、ラベルが表示されます。

スコープ付き一覧

ターゲットを選択する前に、scopeでlist_agentsを使用してリストを絞り込む。

単一エージェント セッションでは、既定のビューは子エージェントを中心としています。 マルチエージェント セッションでは、既定のビューには、ツリー全体ではなく、即時のローカル コンテキストが表示されます。

list_agents(scope="siblings")
list_agents(scope="children")
list_agents(scope="all")

スコープ付きメッセージング

scopeのwrite_agentを使用して、1 つのメッセージを複数の関連エージェントにブロードキャストします。

共有兄弟通信が有効になっている親セッション内で実行されているサブエージェントからのみ、スコープ付きメッセージングを使用します。 最上位レベルのセッションでは、代わりに明示的な agent_id 値を持つエージェントをターゲットにします。

スコープが多すぎるエージェントと一致する場合、write_agentはエラーを返し、代わりにagent_idから明示的なlist_agents値を要求します。

write_agent(scope="children", message="Re-check your findings against the updated schema.")
write_agent(scope="siblings", message="Post status when your current check completes.")
write_agent(agent_id="explore-auth", message="Focus on token refresh flow and report only confirmed issues.")

サブエージェントの制限

CLI では、エージェントのランナウェイ生成を防ぐために、深度とコンカレンシーの制限が適用されます。

深度 は、互いに入れ子になっているエージェントの数をカウントします。 深度制限に達すると、最も内側のエージェントはサブエージェントをさらに生成できません。 コンカレンシー では、セッション ツリー全体で同時に実行されているサブエージェントの数がカウントされます。 制限に達すると、アクティブなエージェントが完了するまで、新しいサブエージェント要求が拒否されます。

既定のコンカレンシー制限は、 Copilot プランによって異なります。

使用量ベースの課金ユーザーは、 subagents.maxConcurrency と subagents.maxDepth の設定でこれらの制限をオーバーライドできます。

{
    "subagents": {
        "maxConcurrency": 16,
        "maxDepth": 10
    }
}

有効な範囲外の値はクランプされます。 maxConcurrency は 32で制限され、 maxDepth は 256で制限されます。 使用量ベースの課金を使用しないプランでは、これらの設定は無視されます。 構成ファイルの設定を参照してください。

サイドキック エージェント

サイドキック エージェントはバックグラウンドで自動的に実行され、セッションの受信トレイにコンテキストを発行します。 明示的に呼び出されるのではなく、セッション イベントに応答します。

sidekick: ブロックを任意のエージェント定義に追加して、それをサイドキック エージェントにします。

---
name: Context Gatherer
description: Gathers relevant context when the working directory changes
sidekick:
    triggers:
        - session.context_changed
        - event: user.message
          limit: 1
    behavior: persistent
    maxSendsPerTurn: 2
---

Gather useful context about the current repository and working directory.
Summarize recent changes and any relevant project structure.

サイドキックの起動条件

triggers の各エントリは、回数に制限なく発生するイベント名のみの文字列、または event と省略可能な limit を持つオブジェクトのいずれかです。

サイドキック構成フィールド

"restart"動作は、ステートレス コンテキスト収集エージェントに適しています。 "persistent"動作は、ターン間で状態を蓄積するエージェントに適しています。

権限承認応答

CLI で操作を実行するためのアクセス許可を求められたら、次のキーを使用して応答できます。

完全なダイアログが表示されたら、次のオプションから選択することもできます。

この場所オプションは、CLI が場所キー (Git ルートまたは現在のディレクトリ) を決定できる場合に表示されます。 承認はディスクに保持されるため、次回そのディレクトリで作業するときに、再度プロンプトを表示せずに同じアクセス許可が自動的に付与されます。

/permissions resetを使用して、現在のセッションのメモリ内承認をクリアします。

セキュリティ

プラン モード

/plan は、 Copilot CLI (コパイロット CLI) がコードベースを調査および分析できるが、プロジェクト ファイルの編集がブロックされる計画セッションを開始します。 Specifically:

• プロジェクト ファイルは保護されています。 ワークスペース内のファイルを変更するシェル コマンドの編集、修正プログラムの適用、または実行の試行は自動的にブロックされます。これはモデルに対する単なる提案ではなく、直接適用されるため、動作を選択するモデルに依存しません。
• プラン自体は引き続き記述できます。 Copilot には、メモを保持し、計画の下書きを行う場所が必要であるため、独自のプライベート計画ワークスペース (確認して承認するプラン ファイルを含む) でファイルを作成および編集できます。
• 委任されたサブタスクも保護されます。 Copilotが質問の一部を調査するためにヘルパー セッションを開始した場合、そのヘルパーは同じ制限を継承し、プロジェクトも編集できません。
• これは、保証ではなく、セーフティ ネットです。 この保護機能は、ファイルを変更しようとする明白で直接的な試みを検知するように設計されていますが、万全の防御策というわけではありません。 調査が過度に制限されないように意図的に許可されるものもあります。たとえば、効果を事前に明確に判断できないシェル コマンドや、接続した外部/MCP ツールの呼び出しなどです。 実際には、これはほとんど問題ではありませんが、プラン モードは、ディスク上の何も変更できないという絶対的な保証ではなく、"変更を適用する前にレビューが必要です" と考える必要があります。

プランに満足したら、プラン モードを終了することを承認し、 Copilot 実際の変更を行います。

コマンドの安全性分析

シェル コマンドは実行前に分析され、潜在的に危険なパターンを特定します。

• ファイルの削除 (rm -rf)
• システムの変更 (sudo、 chmod 777)
• ネットワーク流出 (機密性の高いパスを使用した curl)
• 資格情報アクセス ( .env、SSH キーの読み取り)
• 危険な変数 (たとえば、 PATH=...、 LD_PRELOAD=...) をオーバーライドするインライン環境変数の割り当て

危険度の高いコマンドでは、追加の警告が表示され、明示的な確認が必要です。

サンドボックスが有効で、[ サンドボックスのバイパスを許可する ] 設定がオン (既定)、サンドボックスのファイルシステムまたはネットワーク ポリシーによってブロックされる同期シェル コマンドによって、サンドボックスの外部で再実行するように求められます。モデルのラウンドトリップは必要ありません。 プロンプトを承認すると、コマンドが再実行され、その出力が返されます。 拒否すると、サンドボックス (ブロック) の結果が保持されます。

詳細については、「ローカル サンドボックス設定の構成」を参照してください。

環境変数の拒否リスト

CLI は、それ以外の場合は読み取り専用コマンドでも任意のコードを実行するために利用できる環境変数のインライン割り当てをブロックします。 ブロックされるカテゴリは次のとおりです。

web_fetch SSRF 対策

web_fetch ツールは、HTTP 要求を行う前に、サーバー側要求フォージェリ (SSRF) 保護を適用します。

• プロトコル許可リスト: http:// および https:// URL のみが許可されます。 file:// その他のスキームは拒否されます。
• IP ブロックリスト: ループバック アドレス (127.x.x.x、 ::1)、RFC-1918 プライベート範囲 (10.x、 172.16–31.x、 192.168.x)、クラウド メタデータ エンドポイント ( 169.254.169.254 など) への要求は、IP リテラル チェックと DNS 事前解決によってブロックされます。
• 検証済みのリダイレクト: web_fetch は 3xx リダイレクト (60 秒のネットワーク予算内で最大 10 ホップ) に従い、各ホップのターゲットを同じ IP ブロックリストに対して再検証してから、それに従います。 元の URL とは異なる配信元へのリダイレクトには、他のクロスオリジン フェッチと同じアクセス許可の承認が必要です。同じ配信元のリダイレクトは、追加のプロンプトなしで実行されます。 最終的な結果は、コンテンツが (redirected from <original URL>)されたときの注意事項です。

開発中に web_fetch が localhost に到達できるようにするには (たとえば、ローカル ドキュメント サーバーの場合)、次の環境変数を設定します。

export COPILOT_WEB_FETCH_ALLOW_LOCALHOST=1

OpenTelemetry の監視

Copilot CLI (コパイロット CLI) では、OpenTelemetry (OTel) を使用してトレースとメトリックをエクスポートできるため、エージェントの対話、LLM 呼び出し、ツールの実行、トークンの使用状況を把握できます。 すべてのシグナル名と属性は、 OTel GenAI セマンティック規則に従います。

OTel は既定ではオフで、オーバーヘッドはゼロです。 次のいずれかの条件が満たされるとアクティブになります。

• COPILOT_OTEL_ENABLED=true
• OTEL_EXPORTER_OTLP_ENDPOINT が設定されている
• COPILOT_OTEL_FILE_EXPORTER_PATH が設定されている

OTel 構成は、 VS Codeまたはエンタープライズ全体の managed-settings.json ファイルで設定することもできます。 ドキュメントと VS Code で OTel 監視を有効にするを参照してください。

OTel 環境変数

痕跡

ランタイムは、エージェントの相互作用ごとに階層型スパン ツリーを生成します。 各ツリーには、invoke_agentルート スパンとchatおよびexecute_toolの子スパンが含まれています。

invoke_agent スパン属性

エージェント呼び出し全体をラップします。1 つのユーザー メッセージに対するすべての LLM 呼び出しとツールの実行。

• 最上位レベルのセッションとサブエージェント呼び出し (探索、タスクなど) の両方で、スパンの種類INTERNAL (インプロセス) が使用されます。プロバイダー向けの推論は、子CLIENT``chatスパンによって表されます。
• 最上位レベルのセッション では、さらに server.address と server.portが実行されます。サブエージェント呼び出しでは実行されません。

chat スパン属性

LLM 要求ごとに 1 つのスパン。 スパン種別: CLIENT。

execute_tool スパン属性

ツール呼び出しごとに 1 つのスパン。 スパン種別: INTERNAL。

Metrics

GenAI 慣例メトリック

ベンダー固有のメトリック

Span イベント

アクティブな chat または invoke_agent スパンに記録されたライフサイクル イベント。

リソース属性

すべてのシグナルには、これらのリソース属性が含まれます。

コンテンツ キャプチャ

既定では、プロンプトコンテンツ、応答、またはツール引数はキャプチャされません。モデル名、トークン数、期間などのメタデータのみがキャプチャされます。 完全なコンテンツをキャプチャするには、 OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=true設定します。

コンテンツ キャプチャを有効にすると、次の属性が設定されます。

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

• GitHub Copilot CLI（コマンドラインインターフェース）
• GitHub Copilotフックリファレンス
• GitHub Copilot CLI プラグイン リファレンス
• GitHub Copilot CLI プログラムリファレンス
• GitHub Copilot CLI の構成ディレクトリ