Référence des commandes CLI de GitHub Copilot

Commandes de ligne de commande

Command	Objectif
`copilot`	Lancez l’interface utilisateur interactive.
`copilot help [topic]`	Affichez les informations d’aide. Les rubriques d’aide incluent : `config`, , commands``environment, `logging`, et `permissions`.
`copilot init`	Initialisez les instructions personnalisées de Copilot pour ce référentiel.
`copilot update`	Téléchargez et installez la dernière version.
`copilot version`	Affichez les informations de version et recherchez les mises à jour.
`copilot login`	Authentifiez-vous avec Copilot via le flux de dispositif OAuth. Accepte `--host HOST` de spécifier l’URL de l’hôte GitHub (par défaut : `https://github.com`).
`copilot logout`	Déconnectez-vous de GitHub et supprimez les informations d’identification stockées.
`copilot plugin`	Gérez les plug-ins et les places de marché de plug-ins.

Raccourcis globaux dans l’interface interactive

Shortcut	Objectif
`@ FILENAME`	Incluez le contenu du fichier dans le contexte.

          <kbd>Ctrl</kbd>+<kbd>X</kbd> puis `/`  | Après avoir commencé à saisir un prompt, cela vous permet d’exécuter une commande slash. Par exemple, si vous souhaitez modifier le modèle sans avoir à retaper votre prompt. |

Raccourcis de chronologie dans l’interface interactive

Shortcut	Objectif
ctrl+o	Lorsqu’il n’y a rien dans l’entrée du prompt, cela développe les éléments récents dans la chronologie des réponses de Copilot pour afficher plus de détails.
ctrl+e	Lorsqu’il n’y a rien dans l’entrée du prompt, cela développe tous les éléments dans la chronologie des réponses de Copilot.
ctrl+t	Développer/réduire l’affichage du raisonnement dans les réponses.

Shortcut	Objectif

          <kbd>Ctrl</kbd>+<kbd>A</kbd>        | Passez au début de la ligne (lors de la saisie). |

Commandes slash dans l’interface interactive

Command	Objectif
`/add-dir PATH`	Ajoutez un répertoire à la liste autorisée pour l’accès aux fichiers.
`/agent`	Parcourez et sélectionnez parmi les agents disponibles (le cas échéant).

          `/allow-all`, `/yolo`                               | Activez toutes les autorisations (outils, chemins et URL). |

Pour obtenir la liste complète des commandes de barre oblique disponibles, entrez /help dans l’interface interactive de l’interface CLI.

Options de ligne de commande

Choix	Objectif
`--acp`	Démarrez le serveur de protocole client agent.
`--add-dir PATH`	Ajoutez un répertoire à la liste autorisée pour l’accès aux fichiers (peut être utilisé plusieurs fois).
`--add-github-mcp-tool TOOL`	Ajoutez un outil permettant d’activer le serveur GitHub MCP, au lieu du sous-ensemble CLI par défaut (peut être utilisé plusieurs fois). Utiliser `*` pour tous les outils.
`--add-github-mcp-toolset TOOLSET`	Ajoutez un ensemble d’outils pour activer le serveur GitHub MCP, au lieu du sous-ensemble CLI par défaut (peut être utilisé plusieurs fois). Utiliser `all` pour tous les ensembles d’outils.
`--additional-mcp-config JSON`	Ajoutez un serveur MCP pour cette session uniquement. La configuration du serveur peut être fournie sous la forme d’une chaîne JSON ou d’un chemin d’accès de fichier (préfixe avec `@`). Optimisez la configuration de `~/.copilot/mcp-config.json`. Remplace toute configuration de serveur MCP installée avec le même nom.
`--agent AGENT`	Spécifiez un assistant personnalisé à utiliser.
`--allow-all`	Activez toutes les autorisations (équivalentes à `--allow-all-tools --allow-all-paths --allow-all-urls`).
`--allow-all-paths`	Désactivez la vérification du chemin d’accès du fichier et autorisez l’accès à n’importe quel chemin d’accès.
`--allow-all-tools`	Autoriser l’exécution automatique de tous les outils sans confirmation. Obligatoire lors de l’utilisation de l’interface CLI par programmation (env : `COPILOT_ALLOW_ALL`).
`--allow-all-urls`	Autoriser l’accès à toutes les URL sans confirmation.
`--allow-tool [TOOLS...]`	Les outils que l’interface CLI dispose de l’autorisation d’utiliser. Ne demande pas l’autorisation.
`--allow-url [URLS...]`	Autoriser l’accès à des URL ou domaines spécifiques.
`--alt-screen [VALUE]`	Utilisez la mémoire tampon d’écran de remplacement du terminal (`on` ou `off`).
`--autopilot`	Activez la poursuite de l’autopilot en mode prompt. Consultez « Autoriser GitHub Copilot CLI à fonctionner de manière autonome ».
`--available-tools [TOOLS...]`	Seuls ces outils seront disponibles pour le modèle.
`--banner`	Affichez la bannière de démarrage.
`--bash-env [VALUE]`	Activez la prise en charge de `BASH_ENV` pour les interpréteurs de commandes Bash (`on` ou `off`).
`--config-dir PATH`	Définissez le répertoire de configuration (par défaut : `~/.copilot`).
`--continue`	Reprendre la session la plus récente.
`--deny-tool [TOOLS...]`	Les outils que l’interface CLI n’a pas l’autorisation d’utiliser. Ne demande pas l’autorisation.
`--deny-url [URLS...]`	Refuser l’accès à des URL ou domaines spécifiques est prioritaire sur `--allow-url`.
`--disable-builtin-mcps`	Désactivez tous les serveurs MCP intégrés (actuellement : `github-mcp-server`).
`--disable-mcp-server SERVER-NAME`	Désactivez un serveur MCP spécifique (peut être utilisé plusieurs fois).
`--disable-parallel-tools-execution`	Désactivez l’exécution parallèle d’outils (LLM peut toujours effectuer des appels d’outils parallèles, mais ils seront exécutés séquentiellement).
`--disallow-temp-dir`	Empêchez l’accès automatique au répertoire temporaire système.
`--enable-all-github-mcp-tools`	Activez tous GitHub outils serveur MCP, au lieu du sous-ensemble CLI par défaut. Remplace les options `--add-github-mcp-toolset` et `--add-github-mcp-tool`.
`--excluded-tools [TOOLS...]`	Ces outils ne seront pas disponibles pour le modèle.
`--experimental`	Activer les fonctionnalités expérimentales (utiliser `--no-experimental` pour désactiver).

          `-h`, `--help`                     | Afficher l'aide. |

| -i PROMPT, --interactive PROMPT | Démarrez une session interactive et exécutez automatiquement cette invite. | | --log-dir DIRECTORY | Définissez le répertoire du fichier journal (par défaut : ~/.copilot/logs/). | | --log-level LEVEL | Définissez le niveau de journalisation (choix : none, error, warning, info, debug, all, default). | | --max-autopilot-continues COUNT | Nombre maximal de messages de continuation en mode Autopilot (valeur par défaut : illimitée). Consultez « Autoriser GitHub Copilot CLI à fonctionner de manière autonome ». | | --model MODEL | Définissez le modèle IA que vous souhaitez utiliser. | | --no-alt-screen | Désactivez la mémoire tampon d’écran de remplacement du terminal. | | --no-ask-user | Désactivez l’outil (l’agent ask_user fonctionne de manière autonome sans poser de questions). | | --no-auto-update | Désactivez le téléchargement automatique des mises à jour CLI. | | --no-bash-env | Désactivez la prise en charge de BASH_ENV pour les interpréteurs de commandes Bash. | | --no-color | Désactivez toutes les sorties de couleur. | | --no-custom-instructions | Désactivez le chargement d'instructions personnalisées de AGENTS.md et des fichiers associés. | | --no-experimental | Désactivez les fonctionnalités expérimentales. | | -p PROMPT, --prompt PROMPT | Exécutez un prompt de manière programmatique (quitte après l’exécution). | | --plain-diff | Désactivez le rendu des différences enrichies (mise en surbrillance de la syntaxe via l’outil de différences spécifié par votre configuration Git). | | --resume [SESSION-ID] | Reprenez une session interactive précédente en choisissant dans une liste (spécifiez éventuellement un ID de session). | | -s, --silent | Affichez uniquement la réponse de l’agent (sans statistiques d’utilisation), utile pour l’écriture de scripts avec -p. | | --screen-reader | Activez les optimisations du lecteur d’écran. | | --share [PATH] | Partagez une session dans un fichier Markdown après l’achèvement d’une session programmatique (chemin d’accès par défaut : ./copilot-session-<ID>.md). | | --share-gist | Partagez une session dans un gist secret GitHub après l’exécution d’une session programmatique. | | --stream MODE | Activer ou désactiver le mode de diffusion en continu (choix de mode : on ou off). | | -v, --version | Afficher les informations de version. | | --yolo | Activez toutes les autorisations (équivalentes à --allow-all). |

Pour obtenir la liste complète des commandes et des options, exécutez copilot help.

Modèles d’autorisation d’outil

Les --allow-tool options et --deny-tool acceptent les modèles d’autorisation au format Kind(argument). L’argument est facultatif : l'omission concerne tous les outils de ce type.

Type	Descriptif	Exemples de modèles
`shell`	Exécution de commandes shell

          `shell(git push)`, `shell(git:*)`, `shell` |

| write | Création ou modification de fichier | write, write(src/*.ts) | | read | Lectures de fichiers ou de répertoires | read, read(.env) | | SERVER-NAME | Appel de l’outil serveur MCP | MyMCP(create_issue), MyMCP | | url | Accès URL via web-fetch ou via le shell | url(github.com), url(https://*.api.com) | | memory | Stockage des faits dans la mémoire de l’agent | memory |

Pour shell les règles, le :* suffixe correspond à la tige de commande suivie d’un espace, ce qui empêche les correspondances partielles. Par exemple, shell(git:*) correspond git push et git pull ne correspond giteapas.

Les règles de refus sont toujours prioritaires sur les règles d’autorisation, même lorsque --allow-all est défini.

# 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'

Variables d'environnement

Variable	Descriptif
`COPILOT_MODEL`	Définissez le modèle IA.
`COPILOT_ALLOW_ALL`	Définir sur `true` pour autoriser toutes les autorisations automatiquement (équivalent à `--allow-all`).
`COPILOT_AUTO_UPDATE`	Définissez sur `false` pour désactiver les mises à jour automatiques.
`COPILOT_CUSTOM_INSTRUCTIONS_DIRS`	Liste séparée par des virgules de répertoires supplémentaires pour obtenir des instructions personnalisées.
`COPILOT_SKILLS_DIRS`	Liste séparée par des virgules de répertoires supplémentaires pour les compétences.
`COPILOT_EDITOR`	Commande de l’éditeur pour la modification interactive (cochée après `$VISUAL` et `$EDITOR`).

          `vi` Par défaut, si aucun n’est défini. |

| COPILOT_GITHUB_TOKEN | Jeton d’authentification. Prend la priorité sur GH_TOKEN et GITHUB_TOKEN. | | GH_TOKEN | Jeton d’authentification. Est prioritaire sur GITHUB_TOKEN. | | GITHUB_TOKEN | Jeton d’authentification. | | XDG_CONFIG_HOME | Remplacez le répertoire de configuration. Par défaut : $HOME/.copilot. | | XDG_STATE_HOME | Remplacez le répertoire d’état. Par défaut : $HOME/.copilot. | | USE_BUILTIN_RIPGREP | Définir à false, pour utiliser le ripgrep du système au lieu de la version groupée. | | PLAIN_DIFF | Définissez sur true pour désactiver le rendu des différences enrichies. | | COLORFGBG | Solution de repli pour la détection de terminal à arrière-plan clair/foncé. | | COPILOT_CLI_ENABLED_FEATURE_FLAGS | Liste séparée par des virgules des indicateurs de fonctionnalité à activer (par exemple). "SOME_FEATURE,SOME_OTHER_FEATURE" |

Paramètres du fichier de configuration

Les paramètres utilisateur sont stockés dans ~/.copilot/config.json. Les paramètres au niveau du projet peuvent être placés dans le référentiel .copilot/settings.json (validés) ou .copilot/settings.local.json (remplacements personnels, ajouter à .gitignore). Les paramètres se propagent de l'utilisateur au projet au niveau local, avec des étendues plus spécifiques prenant le pas sur des étendues plus générales. Les indicateurs de ligne de commande et les variables d’environnement sont toujours prioritaires.

Clé	Type	Par défaut	Descriptif
`allowed_urls`	`string[]`	`[]`	URL ou domaines autorisés sans invite.
`alt_screen`	`boolean`	`false`	Utilisez la mémoire tampon d’écran de remplacement du terminal.
`auto_update`	`boolean`	`true`	Téléchargez automatiquement les mises à jour cli.
`banner`

          `"always"`
          \|
          `"once"`
          \|
          `"never"`
         | `"once"` | Fréquence d’affichage de bannière animée. |

Informations de référence sur les hooks

Les hooks sont des commandes externes qui s’exécutent à des points de cycle de vie spécifiques pendant une session, ce qui permet l’automatisation personnalisée, les contrôles de sécurité et les intégrations. Les fichiers de configuration de "hook" sont chargés automatiquement depuis .github/hooks/*.json de votre référentiel.

Format de configuration des hooks

Les fichiers de configuration de hook utilisent le format JSON avec la version 1:

{
  "version": 1,
  "hooks": {
    "preToolUse": [
      {
        "type": "command",
        "bash": "your-bash-command",
        "powershell": "your-powershell-command",
        "cwd": "optional/working/directory",
        "env": { "VAR": "value" },
        "timeoutSec": 30
      }
    ]
  }
}

Champ	Type	Obligatoire	Descriptif
`type`	`"command"`	Oui	Doit être `"command"`.
`bash`	ficelle	L'un de `bash`/`powershell`	Commande Shell pour Unix.
`powershell`	ficelle	L'un de `bash`/`powershell`	Commande Shell pour Windows.
`cwd`	ficelle	Non	Répertoire de travail de la commande (par rapport à la racine du référentiel ou absolu).
`env`	objet	Non	Variables d’environnement à définir (prend en charge l’expansion des variables).
`timeoutSec`	nombre	Non	Délai d’expiration en secondes. Par défaut : `30`.

Événements de hook

Événement	Se déclenche quand	Sortie traitée
`sessionStart`	Une session nouvelle ou reprise commence.	Non
`sessionEnd`	La session se termine.	Non
`userPromptSubmitted`	L’utilisateur envoie une invite.	Non
`preToolUse`	Avant l’exécution de chaque outil.	Oui : peut autoriser, refuser ou modifier.
`postToolUse`	Une fois chaque outil terminé.	Non
`agentStop`	L’agent principal termine un tour.	Oui : peut bloquer et forcer la continuation.
`subagentStop`	Un sous-agent s'achève.	Oui : peut bloquer et forcer la continuation.
`errorOccurred`	Une erreur se produit pendant l’exécution.	Non

          `preToolUse` contrôle de décision

Le preToolUse hook peut contrôler l’exécution de l’outil en écrivant un objet JSON dans stdout.

Champ	Valeurs	Descriptif
`permissionDecision`

          `"allow"`, `"deny"`, `"ask"` | Indique si l’outil s’exécute. La sortie vide utilise le comportement par défaut. |

          `agentStop`
           / 
          `subagentStop` contrôle de décision

Champ	Valeurs	Descriptif
`decision`

          `"block"`, `"allow"` | 
          `"block"` oblige un autre agent à réagir en utilisant `reason` comme invite. |

| reason | ficelle | Demander le tour suivant quand decision est "block". |

Noms d’outils pour la correspondance de hooks

Nom de l’outil	Descriptif
`bash`	Exécuter des commandes shell (Unix).
`powershell`	Exécuter des commandes shell (Windows).
`view`	Lire le contenu du fichier.
`edit`	Modifiez le contenu du fichier.
`create`	Créez des fichiers.
`glob`	Recherchez des fichiers par modèle.
`grep`	Rechercher le contenu du fichier.
`web_fetch`	Récupérer des pages web.
`task`	Exécutez des tâches de sous-agent.

Si plusieurs hooks du même type sont configurés, ils s'exécutent dans l'ordre. Pour preToolUse, si un crochet retourne "deny", l’outil est bloqué. Les échecs de hook (codes de sortie non nuls ou délais d’expiration) sont enregistrés et ignorés. Ils ne bloquent jamais l’exécution de l’agent.

Configuration du serveur MCP

Les serveurs MCP fournissent des outils supplémentaires à l’agent CLI. Configurer des serveurs persistants dans ~/.copilot/mcp-config.json. Permet --additional-mcp-config d’ajouter des serveurs pour une seule session.

Types de transport

Type	Descriptif	Champs obligatoires
`local` / `stdio`	Processus local de communication via stdin/stdout.

          `command`, `args` |

| http | Serveur distant utilisant le transport HTTP par diffusion en continu. | url | | sse | Un serveur distant utilisant le transport d'événements envoyés par le serveur. | url |

Champs de configuration de serveur local

Champ	Obligatoire	Descriptif
`command`	Oui	Commande pour démarrer le serveur.
`args`	Oui	Arguments de commande (tableau).
`tools`	Oui	Outils à activer : `["*"]` pour tous ou une liste de noms d’outils spécifiques.
`env`	Non	Variables d'environnement. Prend en charge `$VAR`, `${VAR}` et `${VAR:-default}` expansion.
`cwd`	Non	Répertoire de travail du serveur.
`timeout`	Non	Délai d’expiration des appels de l’outil en millisecondes.
`type`	Non

          `"local"` ou `"stdio"`. Par défaut : `"local"`. |

Champs de configuration de serveur distant

Champ	Obligatoire	Descriptif
`type`	Oui

          `"http"` ou `"sse"`. |

Mappage de filtres

Contrôlez la façon dont la sortie de l’outil MCP est traitée à l’aide du champ dans la filterMapping configuration d’un serveur.

Mode	Descriptif
`none`	Aucun filtrage.
`markdown`	Formater la sortie en Markdown.
`hidden_characters`	Supprimez les caractères masqués ou de contrôle. Default.

Serveurs MCP intégrés

L’interface CLI inclut des serveurs MCP intégrés disponibles sans configuration supplémentaire.

Serveur	Descriptif
`github-mcp-server`	GitHub Intégration de l’API : problèmes, pull requests, commits, recherche de code et GitHub Actions.
`playwright`	Automatisation du navigateur : naviguez, cliquez, tapez, capture d’écran et gestion des formulaires.
`fetch`	Requêtes HTTP via l’outil `fetch` .
`time`	Utilitaires de temps : `get_current_time` et `convert_time`.

Permet --disable-builtin-mcps de désactiver tous les serveurs intégrés ou --disable-mcp-server SERVER-NAME de désactiver un serveur spécifique.

Informations de référence sur les compétences

Les compétences sont des fichiers Markdown qui étendent ce que l’interface CLI peut faire. Chaque compétence se trouve dans son propre répertoire contenant un SKILL.md fichier. Lorsqu’elle est appelée (via /SKILL-NAME ou automatiquement par l’agent), le contenu de la compétence est injecté dans la conversation.

Champs frontmatter de 'Skill'

Champ	Type	Obligatoire	Descriptif
`name`	ficelle	Oui	Identificateur unique de la compétence. Lettres, chiffres et traits d’union uniquement. 64 caractères maximum.
`description`	ficelle	Oui	Que fait la compétence et quand l’utiliser. Nombre maximal de 1024 caractères.
`allowed-tools`	chaîne ou chaîne[]	Non	Liste séparée par des virgules ou tableau YAML d’outils qui sont automatiquement autorisés lorsque la compétence est active. Utiliser `"*"` pour tous les outils.
`user-invocable`	booléen	Non	Indique si les utilisateurs peuvent appeler la compétence avec `/SKILL-NAME`. Par défaut : `true`.
`disable-model-invocation`	booléen	Non	Empêcher l'agent d'activer automatiquement cette fonctionnalité. Par défaut : `false`.

Emplacements des compétences

Les compétences sont chargées à partir de ces emplacements dans l’ordre de priorité (les premières victoires trouvées pour les noms en double).

Emplacement	Étendue	Descriptif
`.github/skills/`	Projet	Compétences spécifiques au projet.
`.agents/skills/`	Projet	Autre emplacement du projet.
`.claude/skills/`	Projet	Emplacement compatible avec Claude.
Parent `.github/skills/`	Inherited	Prise en charge de l’annuaire parent monorepo.
`~/.copilot/skills/`	Personnel	Compétences personnelles pour tous les projets.
`~/.claude/skills/`	Personnel	Lieu personnel compatible avec Claude.
Répertoires de plug-in	Plug-in	Compétences des plug-ins installés.
`COPILOT_SKILLS_DIRS`	Coutume	Répertoires supplémentaires (séparés par des virgules).

Commandes (autre format de compétence)

Les commandes sont une alternative aux compétences stockées en tant que fichiers individuels .md dans .claude/commands/. Le nom de la commande est dérivé du nom de fichier. Les fichiers de commande utilisent un format simplifié (aucun champ name requis) et prennent en charge description, allowed-tools et disable-model-invocation. Les commandes ont une priorité inférieure à celle des compétences portant le même nom.

Informations de référence sur les agents personnalisés

Les agents personnalisés sont des agents IA spécialisés définis dans les fichiers Markdown. Le nom de fichier (moins l’extension) devient l’ID de l’agent. Utilisez .agent.md ou .md comme extension de fichier.

Agents intégrés

Agent	Modèle par défaut	Descriptif
`explore`	claude-haiku-4.5	Exploration de base de code rapide. Recherche des fichiers, lit le code et répond aux questions. Retourne des réponses ciblées inférieures à 300 mots. Peut s'exécuter en parallèle.
`task`	claude-haiku-4.5	Exécution de commandes (tests, builds, lints). Retourne un résumé bref en cas de réussite, et la sortie complète en cas d’échec.
`code-review`	claude-sonnet-4.5	Révision de code signal-à-bruit élevée. Analyse les différences pour les bogues, les problèmes de sécurité et les erreurs logiques.
`general-purpose`	claude-sonnet-4.5	Agent de capacité complète pour les tâches multi-étapes complexes. S’exécute dans une fenêtre contextuelle distincte.

Champs frontmatter personnalisés d’agent

Champ	Type	Obligatoire	Descriptif
`name`	ficelle	Non	Nom d'affichage. La valeur par défaut est le nom de fichier.
`description`	ficelle	Oui	Description affichée dans la liste des agents et l'outil `task`.
`model`	ficelle	Non	Modèle IA pour cet agent. Lorsqu’il n’est pas défini, hérite du modèle de l’agent externe.
`tools`	chaîne de caractères[]	Non	Outils disponibles pour l’agent. Valeur par défaut : `["*"]` (tous les outils).
`mcp-servers`	objet	Non	Serveurs MCP à connecter. Utilise le même schéma que `~/.copilot/mcp-config.json`.
`infer`	booléen	Non	Autoriser la délégation automatique par l’agent principal. Par défaut : `true`.

Emplacements d’agent personnalisés

Étendue	Emplacement
Projet

          `.github/agents/` ou `.claude/agents/` |

Les agents au niveau du projet sont prioritaires sur les agents au niveau de l’utilisateur. Les agents de plug-in ont la priorité la plus basse.

Réponses d’approbation d’autorisation

Lorsque l’interface CLI demande l’autorisation d’exécuter une opération, vous pouvez répondre avec les clés suivantes.

Clé	Résultat
`y`	Autorisez cette requête spécifique une seule fois.
`n`	Refuser cette demande spécifique une seule fois.
`!`	Autorisez toutes les demandes similaires pour le reste de la session.
`#`	Refuser toutes les demandes similaires pour le reste de la session.
`?`	Affichez des informations détaillées sur la demande.

Les approbations de session sont réinitialisées lorsque vous exécutez ou démarrez /clear une nouvelle session.

Flag	Niveau	Descriptif
`AUTOPILOT_MODE`	`experimental`	Mode d’opération autonome.
`BACKGROUND_AGENTS`	`staff`	Exécutez des agents en arrière-plan.
`QUEUED_COMMANDS`	`staff`	Commandes en file pendant l’exécution de l’agent.
`LSP_TOOLS`	`on`	Outils du Language Server Protocol.
`PLAN_COMMAND`	`on`	Mode de planification interactive.
`AGENTIC_MEMORY`	`on`	Mémoire persistante entre les sessions.
`CUSTOM_AGENTS`	`on`	Définitions d’agent personnalisées.