GitHub Copilot le répertoire de configuration du CLI

Copilot pour CLI stocke sa configuration, son historique de session, ses journaux et ses personnalisations dans un seul répertoire sur votre ordinateur. Par défaut, ce répertoire est ~/.copilot (autrement dit, $HOME/.copilot).

Cet article décrit le contenu de ce répertoire et la façon dont vous pouvez les utiliser.

Vue d’ensemble du répertoire

Le ~/.copilot répertoire contient les éléments de niveau supérieur suivants.

Fichiers modifiables par l’utilisateur

Les fichiers suivants sont conçus pour être modifiés directement ou gérés par le biais de commandes CLI.

settings.json

Il s’agit du fichier de configuration principal pour Copilot pour CLI. Dans une session, vous pouvez utiliser la commande interactive /settings pour modifier des valeurs spécifiques ou exécuter /settings KEY VALUE pour définir une valeur unique. Consultez « Modification des paramètres avec la /settings commande ». Vous pouvez également modifier le settings.json fichier directement dans un éditeur de texte. Le fichier prend en charge JSON avec des commentaires (JSONC).

Par défaut, ce fichier se trouve dans le ~/.copilot répertoire, qui est le répertoire de configuration au niveau de l’utilisateur. Il contient des valeurs par défaut globales au niveau de l’utilisateur pour tous les référentiels. Vous pouvez modifier l’emplacement de ce répertoire en définissant la COPILOT_HOME variable d’environnement sur un chemin différent.

Pour obtenir la liste complète des paramètres et la façon dont ils interagissent avec la configuration au niveau du référentiel, consultez les paramètres du fichier de configuration plus loin dans cet article.

copilot-instructions.md

Instructions personnalisées personnelles qui s’appliquent à toutes vos sessions, quel que soit le projet dans lequel vous travaillez. Ce fichier fonctionne de la même façon qu’au niveau copilot-instructions.md du référentiel, mais s’applique globalement.

Pour plus d’informations, consultez « Ajout d’instructions personnalisées de référentiel pour GitHub Copilot ».

instructions/

Stockez ici des fichiers d’instructions personnelles supplémentaires sous forme de *.instructions.md fichiers. Celles-ci sont chargées en même temps que copilot-instructions.md et s'appliquent à toutes vos sessions. Vous pouvez organiser des instructions par rubrique, par exemple ~/.copilot/instructions/code-style.instructions.md.

mcp-config.json

Définit les serveurs MCP (Model Context Protocol) disponibles au niveau de l’utilisateur. Ces serveurs sont disponibles dans toutes vos sessions, quel que soit le répertoire de projet dans lequel vous vous trouvez. Configurations MCP de niveau projet (dans .mcp.json ou .github/mcp.json) ont la priorité sur les définitions au niveau de l’utilisateur lorsque les noms de serveurs sont en conflit.

Pour plus d’informations, consultez « Ajout de serveurs MCP pour CLI GitHub Copilot ».

lsp-config.json

Définit les serveurs LSP (Language Server Protocol) disponibles au niveau de l’utilisateur. Ces serveurs fournissent une intelligence linguistique (diagnostics, autocomplétions, etc.) à l’agent. Gérez ce fichier à l’aide de la /lsp commande de barre oblique ou modifiez-le directement.

Pour plus d’informations, consultez « Ajout de serveurs LSP pour CLI GitHub Copilot ».

agents/

Stockez les définitions d’agent personnalisé personnelles ici sous forme de .agent.md fichiers. Les agents placés dans ce répertoire sont disponibles dans toutes vos sessions. Les agents de niveau projet (dans .github/agents/) sont prioritaires sur les agents personnels s’ils partagent le même nom.

Pour plus d’informations, consultez « Création et utilisation d’agents personnalisés pour CLI GitHub Copilot ».

skills/

Stockez les définitions de compétences personnalisées personnelles ici. Chaque compétence se trouve dans un sous-répertoire contenant un SKILL.md fichier, par exemple ~/.copilot/skills/my-skill/SKILL.md. Les compétences personnelles sont présentes dans toutes vos sessions. Les compétences de niveau projet ont la priorité sur les compétences personnelles si elles partagent le même nom.

Pour plus d’informations, consultez « Ajout de compétences d’agent pour CLI GitHub Copilot ».

hooks/

Stockez les scripts de hook au niveau de l’utilisateur ici. Ces hooks s’appliquent à toutes vos sessions. Vous pouvez également définir des hooks inline dans votre fichier de configuration utilisateur (~/.copilot/settings.json) à l’aide de la hooks clé. Les hooks au niveau du référentiel (in .github/hooks/) sont chargés en même temps que les hooks au niveau de l’utilisateur.

Pour plus d’informations, consultez « Utilisation de crochets avec CLI GitHub Copilot ».

extensions/

Stockez les fichiers d’extension au niveau de l’utilisateur ici. Les extensions de ce répertoire sont disponibles entre les sessions.

Vous pouvez créer manuellement des fichiers dans ce répertoire ou générer une extension, puis modifier le fichier généré.

Fichiers gérés automatiquement

Les éléments suivants sont gérés par l’interface CLI. Vous ne devez généralement pas les modifier manuellement.

config.json

Stocke l’état d’application interne géré automatiquement par l’interface CLI, notamment les données d’authentification, les métadonnées du plug-in installé et d’autres informations d’exécution. Vous ne devez normalement pas avoir besoin de modifier ce fichier.

permissions-config.json

Stocke vos décisions enregistrées concernant les autorisations d'outils et de répertoires, organisées par emplacement de projet. Lorsque vous approuvez un outil ou accordez l’accès à un répertoire pour l’emplacement actuel, l’interface CLI enregistre la décision ici afin de ne pas être invité à nouveau dans le même référentiel ou répertoire.

Emplacement du fichier

Copilot pour CLI résout le fichier à partir du répertoire de configuration.

L’interface CLI utilise uniquement le premier répertoire de configuration applicable dans cet ordre. Ne charge pas non plus permissions-config.json depuis des emplacements de priorité inférieure.

L’option --config-dir est une option héritée. Préférez COPILOT_HOME lorsque vous devez modifier le répertoire de configuration.

Sur Windows, le fichier par défaut est généralement :

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

Les builds plus anciennes utilisaient un fichier sans extension nommé permissions-config. Si permissions-config.json n’existe pas, mais que le fichier sans extension existe, l’interface de ligne de commande continue de prendre en compte l’ancien fichier. Utiliser permissions-config.json pour les nouvelles modifications.

Les anciens emplacements de configuration basés sur XDG sont transférés vers ~/.copilot au démarrage lorsque COPILOT_HOME n’est pas défini.

Clés de localisation

L’objet locations de niveau supérieur a pour clé un chemin absolu.

• Pour un dépôt Git, utilisez la racine Git servant à définir la portée des autorisations.
• Les arborescences de travail liées renvoient à la racine du référentiel principal, de sorte qu’elles partagent les mêmes droits que l’arborescence de travail principale.
• Les sous-modules utilisent leur propre répertoire de travail.
• Pour un répertoire qui ne se trouve pas dans un référentiel Git, utilisez le répertoire de travail actuel normalisé.

La clé doit correspondre à l’emplacement où Copilot pour CLI s’exécute. Si la clé ne correspond pas, les approbations enregistrées ne s’appliquent pas.

L’interface CLI charge les approbations de l’emplacement correspondant lorsqu’une session démarre et lorsque le répertoire de travail actif change.

Schema

Le fichier doit contenir un objet JSON.

permissions-config.json ne prend pas en charge les règles de refus, les règles « ask », les modes par défaut, les règles d’URL, le filtrage d’outils ou la stratégie partagée locale du référentiel. Pour ces comportements, utilisez des options de ligne de commande telles que --deny-tool, , --available-tools``--excluded-tools, --allow-url, , et --deny-url. Les règles d’URL enregistrées sont stockées dans settings.json, et non dans permissions-config.json.

Les champs inconnus ne font pas partie du schéma. L’interface CLI peut les ignorer, et les écritures ultérieures peuvent les supprimer.

Types d’approbation

Chaque élément dans tool_approvals doit être l’un des objets suivants.

Pour les approbations MCP, serverName doit correspondre exactement au nom du serveur MCP configuré. Utilisez le nom de serveur brut de votre configuration MCP, et non un préfixe de nom d’outil nettoyé.

Correspondance des commandes shell

permissions-config.json ne prend pas en charge les expressions régulières ni les motifs génériques de type glob. Les valeurs de chaîne sont mises en correspondance de manière littérale, sauf qu’un :* final dans une valeur d’interpréteur de commandes commandIdentifiers correspond au texte situé avant :*, soit seul, soit suivi d’un espace et d’autre texte. Une plaine * n’a pas de signification particulière, donc git* ne correspond git statuspas .

Mise en correspondance des répertoires

Les allowed_directories entrées permettent à Copilot pour CLI d’accéder aux chemins situés dans ces répertoires sans demande distincte de chemin d’accès. Ils n’approuvent pas le fonctionnement même de l’outil. Par exemple, la modification d’un fichier dans un répertoire autorisé peut toujours nécessiter une write approbation.

Chaque allowed_directories entrée doit être un répertoire absolu, non vide et accessible. L’interface en ligne de commande (CLI) résout les liens symboliques avant de comparer les chemins d’accès, bloque les chemins réseau UNC sauf s’il s’agit de chemins locaux de longueur étendue, compare les chemins d’accès sans tenir compte de la casse sous Windows et les compare en tenant compte de la casse sur les autres plateformes. Si une entrée ne peut pas être appliquée, l’interface CLI enregistre un avertissement et ignore cette entrée.

Exemples

Autorisez toutes les sous-commandes Git et accédez à un répertoire local supplémentaire :

{
  "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"]
    }
  }
}

Autoriser les commandes sélectionnées tout en demandant toujours une confirmation avant toute écriture de fichier :

{
  "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"
          ]
        }
      ]
    }
  }
}

Approuver les écritures de fichiers et un serveur MCP pour un référentiel :

{
  "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
        }
      ]
    }
  }
}

Approuvez un outil MCP, des écritures de mémoire et un accès aux autorisations d’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"
        }
      ]
    }
  }
}

{
  "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/

Contient des données d’historique de session, organisées par ID de session dans les sous-répertoires. Chaque répertoire de session stocke un journal des événements (events.jsonl) et des artefacts d’espace de travail (plans, points de contrôle, fichiers suivis). Ces données activent la reprise de session (--resume ou --continue).

La suppression de fichiers de ce répertoire supprime uniquement les copies locales. Si vous avez synchronisé des sessions avec votre GitHub compte, les données synchronisées sont stockées séparément et ne sont pas affectées par la suppression de fichier local. Vous pouvez supprimer ou masquer les sessions synchronisées à partir de GitHub.com. Pour plus d’informations, consultez « À propos des CLI GitHub Copilot données de session ».

command-history-state/

Contient les données d’historique des commandes utilisées pour la recherche inversée (Ctrl+R) et la navigation dans l’historique dans l’interface interactive. Ce répertoire est géré automatiquement et ne doit pas être modifié.

session-store.db

Base de données SQLite utilisée par l’interface CLI pour les données intersession, telles que l’indexation et la recherche de point de contrôle. Ce fichier est géré automatiquement et ne doit pas être modifié.

Si vous supprimez ce fichier, vous pouvez le reconstruire à l’aide de la /chronicle reindex commande. La réindexation synchronise également vos données de session avec votre compte.

logs/

Contient des fichiers journaux pour les sessions CLI. Chaque session crée un fichier journal nommé process-{timestamp}-{pid}.log. Ces fichiers sont utiles pour déboguer des problèmes.

L’interface CLI peut également créer des journaux propres à certaines extensions dans le répertoire logs/extensions/.

Ceci est distinct de ~/.copilot/extensions/, qui stocke le code d’extension créé par l’utilisateur.

installed-plugins/

Contient les fichiers des plug-ins que vous avez installés. Les plug-ins installés à partir d’une Place de marché sont stockés sous installed-plugins/{marketplace-name}/{plugin-name}/. Les plug-ins directement installés sont stockés sous installed-plugins/_direct/. Gérez les plug-ins à l’aide copilot plugin des commandes plutôt que de modifier ce répertoire directement.

Pour plus d’informations, consultez « Référence du plug-in CLI GitHub Copilot ».

plugin-data/

Contient des données persistantes pour les plug-ins installés, organisées par nom de la Place de marché et du plug-in. Ces données sont gérées par les plug-ins eux-mêmes et ne doivent pas être modifiées manuellement.

ide/

Contient des fichiers de verrouillage et l'état pour les intégrations IDE (par exemple, lorsque Copilot pour CLI se connecte à Visual Studio Code). Ce répertoire est géré automatiquement.

mcp-oauth-config/

Contient les fichiers relatifs aux jetons OAuth MCP, à l’enregistrement et au mécanisme de secours PKCE lorsque le stockage basé sur le trousseau n’est pas disponible. Ce répertoire est géré automatiquement.

mcp-secrets/

Contient le stockage de secours sous forme de fichiers ainsi qu’un index des espaces réservés des secrets MCP lorsque le stockage basé sur le trousseau n’est pas disponible. Ce répertoire est géré automatiquement.

Modification de l’emplacement du répertoire de configuration

Pour remplacer l’emplacement par défaut ~/.copilot , définissez la COPILOT_HOME variable d’environnement sur le chemin du répertoire que vous souhaitez utiliser.

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

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

Éléments à prendre en compte

• COPILOT_HOME remplace l’intégralité du chemin d’accès ~/.copilot. La valeur que vous définissez doit être le chemin complet du répertoire que vous souhaitez utiliser pour les fichiers de configuration et les sous-répertoires.

• La modification du répertoire signifie que votre configuration existante, l’historique des sessions, les plug-ins installés et les autorisations enregistrées sont introuvables dans le nouvel emplacement. Copiez ou déplacez le contenu de ~/.copilot vers le nouvel emplacement si vous souhaitez le conserver.

• Le répertoire de cache (utilisé pour les caches de la Place de marché, les packages de mise à jour automatique et d’autres données éphémères) suit les conventions de plateforme et n’est pas affecté par COPILOT_HOME. Il se trouve à :

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

  Pour remplacer le répertoire du cache séparément, définissez COPILOT_CACHE_HOME.

Ce que vous pouvez supprimer en toute sécurité

Paramètres du fichier de configuration

Les paramètres sont appliqués dans cet ordre (les suivants remplacent les précédents) :

1. Valeurs par défaut intégrées
2. Paramètres gérés par la gestion des appareils mobiles (MDM)
3. Paramètres utilisateur (~/.copilot/settings.json)
4. Paramètres du référentiel (.github/copilot/settings.json)
5. Paramètres locaux (.github/copilot/settings.local.json)
6. Variables d’environnement
7. Indicateurs de ligne de commande

Les paramètres gérés par MDM sont chargés au démarrage et fusionnent avec les paramètres utilisateur comme base de référence de la stratégie. Pour la plupart des clés, les paramètres utilisateur peuvent remplacer cette ligne de base. Pour permissions.disableBypassPermissionsMode, une valeur MDM de "disable" prévaut toujours. Pour plus d’informations, consultez les paramètres managés MDM.

L’interface CLI lit également .claude/settings.json et .claude/settings.local.json pour le sous-ensemble partagé de paramètres de dépôt commun à plusieurs outils (tels que companyAnnouncements, disableAllHooks, enabledPlugins, extraKnownMarketplaces et hooks).

Paramètres utilisateur (~/.copilot/settings.json)

Ces paramètres s’appliquent à toutes vos sessions et référentiels. Vous pouvez utiliser la /settings commande de barre oblique pour exécuter une boîte de dialogue interactive, ou utiliser des commandes de barre oblique spécifiques pour mettre à jour des valeurs individuelles ou modifier ce fichier directement.

Paramètres du référentiel (.github/copilot/settings.json)

Les paramètres du référentiel s’appliquent à tous ceux qui travaillent dans le référentiel. Ils sont commités dans le référentiel et partagés avec les collaborateurs.

Seules les clés répertoriées dans le tableau suivant sont prises en charge au niveau du référentiel. Toutes les autres clés, y compris les clés valides dans le fichier de configuration utilisateur, sont ignorées en mode silencieux. Chaque clé prise en charge dispose d’une stratégie de fusion directionnelle qui garantit que la surcharge reste fermée en cas d’échec et sécurisée.

model, effortLevel, et contextTier ne s’appliquent que lorsque le répertoire de travail est de confiance.

Un plug-in activé uniquement par le biais de ce enabledPlugins référentiel est limité à ce référentiel : il installe et s’active automatiquement dans le référentiel déclarant, mais reste désactivé globalement, de sorte qu’il n’est jamais activé dans des projets non liés. Lorsque vous quittez le dépôt, ou que le dépôt désactive le plugin, son serveur MCP s’arrête et ses agents ainsi que ses compétences sont désactivés pour la session.

Liste d’autorisation des modèles au niveau du dépôt (.github/allowed_models.txt)

Limitez les modèles intégrés qu’un dépôt est autorisé à utiliser à l’aide d’une liste d’autorisation en texte brut dans .github/allowed_models.txt, située à la racine du dépôt correspondant au répertoire de travail actuel (ou dans le répertoire de travail lui-même en dehors d’un dépôt).

Chaque ligne est un motif glob appliqué aux ID de modèle, ou une directive fallback: indiquant le modèle à utiliser lorsque le modèle configuré ou demandé n’est pas autorisé :

# .github/allowed_models.txt
fallback: gpt-5.2
gpt-5.2
gpt-5.4
claude-sonnet-*

Les motifs négatifs (!pattern) ne sont pas pris en charge, le modèle de secours doit être un ID exact (et non un glob), et le modèle de secours doit lui-même correspondre à l’un des globs configurés. Copilot pour CLI réévalue la stratégie sur /cd et rejette un fichier non valide avec une erreur avant l’exécution.

La liste d’autorisation ne concerne que les modèles intégrés de Copilot. Il ne peut pas filtrer les modèles personnalisés ajoutés à l’aide de la méthode BYOK (Bring Your Own API Keys). Les modèles BYOK restent répertoriés et sélectionnables, quels que soient les modèles que vous configurez, et la fallback: directive ne s’applique jamais à ces modèles. Pour plus d’informations, consultez « Activation de modèles personnalisés pour GitHub Copilot dans votre entreprise » et « Activation de modèles personnalisés pour GitHub Copilot dans votre organisation ».

Paramètres locaux (.github/copilot/settings.local.json)

Créez .github/copilot/settings.local.json dans le dépôt, pour les remplacements personnels qui ne doivent pas être validés. Ajoutez ce fichier à .gitignore.

Le fichier de configuration local utilise le même schéma que le fichier de configuration du référentiel (.github/copilot/settings.json) et est prioritaire sur celui-ci.

Paramètres gérés par MDM

Les administrateurs informatiques peuvent déployer une stratégie de référence à l’aide des paramètres gérés par la gestion des appareils mobiles (MDM), au lieu d’exiger une configuration pour chaque utilisateur. Ces paramètres définissent les valeurs par défaut au niveau de l’appareil pour les clés prises en charge et sont chargés avant les paramètres utilisateur.

Copilot pour CLI charge également les paramètres gérés par le serveur au démarrage, en plus de MDM. Les paramètres gérés par l’appareil (MDM) et par le serveur sont appliqués par clé : la valeur de MDM prévaut pour toute clé qu’il définit, et la valeur du serveur complète les clés que MDM laisse non définies. Cela permet à une organisation de définir une stratégie via mdm (par exemple) permissionstout en recevant d’autres valeurs par défaut managées (par exemple, model) à partir du serveur.

Les sessions de longue durée récupèrent et réappliquent les paramètres managés toutes les heures, de sorte que les modifications de stratégie (par exemple, une organisation qui l’active permissions.disableBypassPermissionsMode) prennent effet sans redémarrer la session.

Sources des paramètres gérés par MDM

Copilot pour CLI lit les paramètres gérés depuis des emplacements MDM propres à la plate-forme ou basés sur des fichiers.

Format de fichier

Écrire des paramètres managés basés sur des fichiers en tant que JSON.

{
    "model": "auto",
    "permissions": {
        "disableBypassPermissionsMode": "disable"
    }
}

Clés prises en charge

Seules les clés suivantes sont prises en charge dans les paramètres managés MDM.

Liste d’autorisation/refus du serveur MCP managé

Les administrateurs peuvent gérer directement les serveurs MCP via les paramètres gérés par MDM, indépendamment de la liste d’autorisation MCP de l’entreprise.

Définissez allowedMcpServers et/ou deniedMcpServers dans une source de paramètres managés :

{
    "allowedMcpServers": [
        { "serverUrl": "https://mcp.example.com/*" },
        { "serverCommand": ["npx", "-y", "@example/mcp-server"] }
    ],
    "deniedMcpServers": [
        { "serverName": "untrusted-server" }
    ]
}

Chaque entrée identifie un serveur à l’aide d’un seul des critères de correspondance suivants.

Règlement:

• Les serveurs internes approuvés (par exemple, le serveur MCP intégré GitHub ) sont toujours exemptés des deux listes.
• Unset allowedMcpServers autorise tous les serveurs non par défaut ; un tableau vide les bloque tous (deny-all).
• Non défini ou vide deniedMcpServers ne bloque rien.
• Le refus l’emporte toujours—un serveur correspondant à deniedMcpServers est bloqué même s’il correspond aussi à allowedMcpServers.
• Pour les serveurs distants, une correspondance doit provenir d’une serverUrl entrée ; serverName compte uniquement lorsqu’aucune entrée n’existe serverUrl . Pour les serveurs stdio, une correspondance doit provenir d’une serverCommand entrée ; serverName compte uniquement lorsqu’aucune entrée n’existe serverCommand .

Lectures complémentaires

• CLI GitHub Copilot
• Référence de commande CLI pour GitHub Copilot
• référence programmatique du CLI GitHub Copilot
• Référence du plug-in CLI GitHub Copilot
• Références sur les hooks GitHub Copilot