GitHub Copilot CLI の構成ディレクトリ

Copilot CLI (コパイロット CLI) では、構成、セッション履歴、ログ、カスタマイズがコンピューター上の 1 つのディレクトリに格納されます。 既定では、このディレクトリは ~/.copilot (つまり、 $HOME/.copilot) です。

この記事では、このディレクトリの内容とその使用方法について説明します。

ディレクトリの概要

~/.copilot ディレクトリには、次の最上位項目が含まれています。

ユーザーが編集可能なファイル

次のファイルは、ユーザーが直接編集するか、CLI コマンドを使用して管理するように設計されています。

settings.json

これは、 Copilot CLI (コパイロット CLI)のプライマリ構成ファイルです。 セッション内では、対話型の /settings コマンドを使用して特定の値を変更したり、 /settings KEY VALUE を実行して 1 つの値を設定したり、テキスト エディターで直接ファイルを編集したりできます。 このファイルは、コメント付き JSON (JSONC) をサポートしています。

設定の完全な一覧と、リポジトリ レベルの構成との対話方法については、この記事で後述する 構成ファイルの設定 を参照してください。

copilot-instructions.md

作業しているプロジェクトに関係なく、すべてのセッションに適用される個人のカスタム指示。 このファイルはリポジトリ レベルの copilot-instructions.md と同じように動作しますが、グローバルに適用されます。

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

instructions/

追加の個人用命令ファイルを *.instructions.md ファイルとしてここに格納します。 これらは copilot-instructions.md と共に読み込まれ、すべてのセッションに適用されます。 ~/.copilot/instructions/code-style.instructions.mdなど、トピックごとに手順を整理できます。

mcp-config.json

ユーザー レベルで使用できる MCP (モデル コンテキスト プロトコル) サーバーを定義します。 これらのサーバーは、使用しているプロジェクト ディレクトリに関係なく、すべてのセッションで使用できます。 Projectレベルの MCP 構成 (.mcp.json または .github/mcp.json) は、サーバー名の競合時にユーザー レベルの定義よりも優先されます。

詳細については、「GitHub Copilot CLI（コマンドラインインターフェース） 用の MCP サーバーを追加する」を参照してください。

lsp-config.json

ユーザー レベルで使用できる言語サーバー プロトコル (LSP) サーバーを定義します。 これらのサーバーは、エージェントに言語インテリジェンス (診断、完了など) を提供します。 /lspスラッシュ コマンドを使用してこのファイルを管理するか、直接編集します。

詳細については、「LSP サーバーの追加 GitHub Copilot CLI（コマンドラインインターフェース）」を参照してください。

agents/

個人用カスタム エージェント定義を .agent.md ファイルとしてここに格納します。 このディレクトリに配置されたエージェントは、すべてのセッションで使用できます。 Projectレベルのエージェント (.github/agents/) は、同じ名前を共有する場合は、個人エージェントよりも優先されます。

詳細については、「GitHub Copilot CLI（コマンドラインインターフェース） のカスタムエージェントの作成と使用」を参照してください。

skills/

個人のカスタム スキル定義をここに格納します。 各スキルは、 SKILL.md ファイル ( ~/.copilot/skills/my-skill/SKILL.md など) を含むサブディレクトリに存在します。 個人のスキルはすべてのセッションで利用できます。 Projectレベルのスキルは、同じ名前を共有する場合、個人のスキルよりも優先されます。

詳細については、「エージェント スキルの追加 GitHub Copilot CLI（コマンドラインインターフェース）」を参照してください。

hooks/

ユーザー レベルのフック スクリプトをここに格納します。 これらのフックは、すべてのセッションに適用されます。 ~/.copilot/settings.json キーを使用して、ユーザー構成ファイル (hooks) でフックをインラインで定義することもできます。 リポジトリ レベルのフック ( .github/hooks/) は、ユーザー レベルのフックと共に読み込まれます。

詳細については、「GitHub Copilot CLI（コマンドラインインターフェース） でフックを使用する」を参照してください。

extensions/

ユーザー レベルの拡張ファイルをここに格納します。 このディレクトリ内の拡張機能は、セッション間で使用できます。

このディレクトリにファイルを手動で作成するか、拡張機能をスキャフォールディングしてから、生成されたファイルを編集できます。

ファイルを自動的に管理する

次の項目は CLI によって管理されます。 通常、手動で編集しないでください。

config.json

認証データ、インストールされているプラグイン メタデータ、その他のランタイム情報など、CLI によって自動的に管理される内部アプリケーションの状態を格納します。 通常、このファイルを編集する必要はありません。

permissions-config.json

保存したツールとディレクトリのアクセス許可の決定をプロジェクトの場所別に格納します。 ツールを承認するか、現在の場所のディレクトリへのアクセスを許可すると、CLI によって決定がここに記録されるため、同じリポジトリまたはディレクトリに再度プロンプトが表示されることはありません。

ファイルの場所

Copilot CLI (コパイロット CLI) は、構成ディレクトリからファイルを解決します。

--config-dir オプションは従来のオプションです。 構成ディレクトリを変更する必要がある場合は、 COPILOT_HOME を優先します。

Windowsでは、既定のファイルは通常次のようになります。

C:\Users\YOUR-USER\.copilot\permissions-config.json

以前のビルドでは、 permissions-configという名前の拡張子のないファイルが使用されています。 permissions-config.jsonが存在しないが、拡張子のないファイルが存在する場合、CLI はレガシ ファイルを引き続き受け入れられます。 新しい編集には permissions-config.json を使用します。

以前の XDG ベースの構成場所は、~/.copilotが設定されていない場合、起動時にCOPILOT_HOMEに移行されます。

位置キー

最上位レベルの locations オブジェクトは、絶対パスによってキーが設定されます。

• Git リポジトリの場合は、アクセス許可のスコープに使用される Git ルートを使用します。
• リンクされたワークツリーはメイン リポジトリのルートを参照するため、メインワークツリーと権限を共有します。
• サブモジュールは、独自の作業ディレクトリを使用します。
• Git リポジトリにないディレクトリの場合は、正規化された現在の作業ディレクトリを使用します。

キーは、 Copilot CLI (コパイロット CLI) が実行されている場所と一致する必要があります。 キーが一致しない場合、保存された承認は適用されません。

CLI は、セッションの開始時とアクティブな作業ディレクトリの変更時に、一致する場所の承認を読み込みます。

Schema

ファイルには JSON オブジェクトが含まれている必要があります。

permissions-config.json では、拒否ルール、"ask" ルール、既定のモード、URL ルール、ツール のフィルター処理、またはリポジトリローカル共有ポリシーはサポートされていません。 これらの動作では、 --deny-tool、 --available-tools、 --excluded-tools、 --allow-url、 --deny-urlなどのコマンド ライン オプションを使用します。 保存された URL ルールは、settings.jsonではなく、permissions-config.jsonに格納されます。

不明なフィールドはスキーマの一部ではありません。 CLI では無視され、後で書き込みによって削除される場合があります。

承認の種類

tool_approvalsの各項目は、次のいずれかのオブジェクトである必要があります。

MCP 承認の場合、 serverName は構成された MCP サーバー名と正確に一致する必要があります。 サニタイズされたツール名プレフィックスではなく、MCP 構成の生サーバー名を使用します。

シェルコマンドの照合

commandIdentifiers は、シェル要求から抽出されたコマンド識別子と一致します。 一致は、 :* サフィックスを除いて正確です。

:*サフィックスは、一般的な glob パターンではありません。 これは、ステムそのもの、またはステムの後にスペースと追加のテキストが続くものに一致します。

ディレクトリ マッチング

allowed_directories エントリを使用すると、 Copilot CLI (コパイロット CLI) は個別のパス プロンプトなしで、これらのディレクトリ内のパスにアクセスできます。 ツール操作自体は承認されません。 たとえば、許可されたディレクトリ内のファイルを編集するには、引き続き write の承認が必要な場合があります。

各 allowed_directories エントリは、絶対、空でない、アクセス可能なディレクトリである必要があります。 CLI は、パスを比較する前にシンボリック リンクを解決し、UNC ネットワーク パスは拡張長ローカル パスでない限り許可せず、Windows では大文字と小文字を区別せずにパスを比較し、その他のプラットフォームでは大文字と小文字を区別してパスを比較します。 エントリを適用できない場合、CLI は警告をログに記録し、そのエントリをスキップします。

例示

すべての Git サブコマンドを許可し、追加のローカル ディレクトリにアクセスします。

{
  "locations": {
    "C:\\src\\my-repo": {
      "tool_approvals": [
        {
          "kind": "commands",
          "commandIdentifiers": ["git:*"]
        }
      ],
      "allowed_directories": ["C:\\src\\shared-docs"]
    }
  }
}

{
  "locations": {
    "C:\\src\\my-repo": {
      "tool_approvals": [
        {
          "kind": "commands",
          "commandIdentifiers": ["git:*"]
        }
      ],
      "allowed_directories": ["C:\\src\\shared-docs"]
    }
  }
}

ファイルの書き込み前に確認しながら、選択したコマンドを許可します。

{
  "locations": {
    "/Users/YOUR-USER/src/my-repo": {
      "tool_approvals": [
        {
          "kind": "commands",
          "commandIdentifiers": [
            "git status",
            "git diff",
            "git log",
            "npm test",
            "npm run build"
          ]
        }
      ]
    }
  }
}

{
  "locations": {
    "/Users/YOUR-USER/src/my-repo": {
      "tool_approvals": [
        {
          "kind": "commands",
          "commandIdentifiers": [
            "git status",
            "git diff",
            "git log",
            "npm test",
            "npm run build"
          ]
        }
      ]
    }
  }
}

リポジトリのファイル書き込みと 1 つの MCP サーバーを承認します。

{
  "locations": {
    "/home/YOUR-USER/src/my-repo": {
      "tool_approvals": [
        {
          "kind": "write"
        },
        {
          "kind": "mcp",
          "serverName": "github-mcp-server",
          "toolName": null
        }
      ]
    }
  }
}

{
  "locations": {
    "/home/YOUR-USER/src/my-repo": {
      "tool_approvals": [
        {
          "kind": "write"
        },
        {
          "kind": "mcp",
          "serverName": "github-mcp-server",
          "toolName": null
        }
      ]
    }
  }
}

1つのMCPツール、メモリへの書き込み、拡張機能の権限へのアクセスを承認する:

{
  "locations": {
    "C:\\src\\my-repo": {
      "tool_approvals": [
        {
          "kind": "mcp",
          "serverName": "github-mcp-server",
          "toolName": "search_code"
        },
        {
          "kind": "memory"
        },
        {
          "kind": "extension-permission-access",
          "extensionName": "my-extension"
        }
      ]
    }
  }
}

{
  "locations": {
    "C:\\src\\my-repo": {
      "tool_approvals": [
        {
          "kind": "mcp",
          "serverName": "github-mcp-server",
          "toolName": "search_code"
        },
        {
          "kind": "memory"
        },
        {
          "kind": "extension-permission-access",
          "extensionName": "my-extension"
        }
      ]
    }
  }
}

session-state/

サブディレクトリ内のセッション ID 別に整理されたセッション履歴データが含まれています。 各セッション ディレクトリには、イベント ログ (events.jsonl) とワークスペース成果物 (プラン、チェックポイント、追跡されたファイル) が格納されます。 このデータにより、セッションの再開 (--resume または --continue) が有効になります。

このディレクトリからファイルを削除すると、ローカル コピーのみが削除されます。 GitHub アカウントにセッションを同期した場合、同期されたデータは個別に保存され、ローカル ファイルの削除の影響を受けません。 同期されたセッションは、 GitHub.comから削除したり非表示にしたりできます。 詳細については、「セッション データ GitHub Copilot CLI（コマンドラインインターフェース） について」を参照してください。

command-history-state/

対話型インターフェイスの逆引き検索 (Ctrl+R) と履歴ナビゲーションに使用されるコマンド履歴データが含まれています。 このディレクトリは自動的に管理されるため、編集しないでください。

session-store.db

チェックポイントのインデックス作成や検索などのセッション間データに CLI によって使用される SQLite データベース。 このファイルは自動的に管理され、編集しないでください。

このファイルを削除した場合は、 /chronicle reindex コマンドを使用してリビルドできます。 インデックスを再作成すると、セッション データもアカウントに同期されます。

logs/

CLI セッションのログ ファイルが含まれています。 各セッションでは、 process-{timestamp}-{pid}.logという名前のログ ファイルが作成されます。 これらのファイルは、問題のデバッグに役立ちます。

CLI では、 logs/extensions/の下に拡張機能固有のログを作成することもできます。

これは、ユーザーが作成した拡張機能コードを格納する ~/.copilot/extensions/とは別です。

installed-plugins/

インストールしたプラグインのファイルが含まれています。 マーケットプレースからインストールされたプラグインは、 installed-plugins/{marketplace-name}/{plugin-name}/の下に格納されます。 直接インストールされたプラグインは、 installed-plugins/_direct/の下に格納されます。 このディレクトリを直接編集するのではなく、 copilot plugin コマンドを使用してプラグインを管理します。

詳細については、「GitHub Copilot CLI プラグイン リファレンス」を参照してください。

plugin-data/

マーケットプレースとプラグイン名別に整理された、インストールされているプラグインの永続的なデータが含まれています。 このデータはプラグイン自体によって管理されるため、手動で編集することはできません。

ide/

IDE 統合のロック ファイルと状態が含まれます (たとえば、 Copilot CLI (コパイロット CLI) が Visual Studio Code に接続する場合)。 このディレクトリは自動的に管理されます。

mcp-oauth-config/

キーチェーンベースのストレージが使用できない場合の MCP OAuth トークン、登録、PKCE フォールバック ファイルが含まれます。 このディレクトリは自動的に管理されます。

mcp-secrets/

キーチェーンベースのストレージが使用できない場合のフォールバック ファイル ストレージと MCP シークレット プレースホルダーのインデックスが含まれます。 このディレクトリは自動的に管理されます。

構成ディレクトリの場所の変更

既定の ~/.copilot 場所をオーバーライドするには、 COPILOT_HOME 環境変数を使用するディレクトリのパスに設定します。

export COPILOT_HOME=/path/to/my/copilot-config

export COPILOT_HOME=/path/to/my/copilot-config

注意すべき事項

• COPILOT_HOME は、 ~/.copilot パス全体を置き換えます。 設定する値は、構成ファイルとサブディレクトリに使用するディレクトリへの完全なパスである必要があります。

• ディレクトリを変更すると、既存の構成、セッション履歴、インストールされているプラグイン、保存されたアクセス許可が新しい場所に見つかりません。 ~/.copilotの内容を保存する場合は、新しい場所にコピーまたは移動します。

• キャッシュ ディレクトリ (Marketplace キャッシュ、自動更新パッケージ、およびその他のエフェメラル データに使用) はプラットフォームの規則に従い、COPILOT_HOMEの影響を受けません。 これは次の場所にあります。

  • macOS: ~/Library/Caches/copilot
  • Linux: $XDG_CACHE_HOME/copilot または ~/.cache/copilot
  • Windows:%LOCALAPPDATA%/copilot

  キャッシュ ディレクトリを個別にオーバーライドするには、 COPILOT_CACHE_HOME設定します。

安全に削除できる内容

構成ファイルの設定

設定はユーザーからリポジトリ、そしてローカルへと階層的に適用され、より具体的なスコープがより一般的なスコープを上書きします。 コマンド ライン オプションと環境変数は常に最も優先順位が高くなります。

CLI では、リポジトリ設定の共有クロスツール サブセット (.claude/settings.json、.claude/settings.local.json、companyAnnouncements、disableAllHooks、enabledPluginsなど) のextraKnownMarketplacesとhooksも読み取ります。

ユーザー設定 (~/.copilot/settings.json)

これらの設定は、すべてのセッションとリポジトリに適用されます。 /settingsスラッシュ コマンドを使用して対話型ダイアログを実行したり、特定のスラッシュ コマンドを使用して個々の値を更新したり、このファイルを直接編集したりできます。

リポジトリの設定 (.github/copilot/settings.json)

リポジトリの設定は、リポジトリ内で作業するすべてのユーザーに適用されます。 これらはリポジトリにコミットされ、コラボレーターと共有されます。

リポジトリ レベルでは、次の表に示すキーのみがサポートされています。 その他のキー (ユーザー構成ファイルで有効なキーを含む) は、暗黙的に無視されます。

ローカル設定 (.github/copilot/settings.local.json)

コミットすべきでない個人用オーバーライドの .github/copilot/settings.local.json をリポジトリに作成します。 このファイルを .gitignoreに追加します。

ローカル構成ファイルは、リポジトリ構成ファイル (.github/copilot/settings.json) と同じスキーマを使用し、そのスキーマよりも優先されます。

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

• GitHub Copilot CLI（コマンドラインインターフェース）
• GITHUB COPILOT CLI コマンド リファレンス
• GitHub Copilot CLI プログラムリファレンス
• GitHub Copilot CLI プラグイン リファレンス
• GitHub Copilotフックリファレンス