Utilisation du CLI GitHub Copilot

L’interface de ligne de commande (CLI) de GitHub Copilot vous permet d’utiliser Copilot directement depuis votre terminal. Pour plus d’informations, consultez « À propos de GitHub Copilot CLI ».

Conditions préalables

Installez Copilot CLI. Consultez « Installation de GitHub Copilot CLI ».

Utilisation de Copilot CLI

Dans votre terminal, accédez à un dossier qui contient le code que vous souhaitez utiliser.
Entrez copilot pour démarrer Copilot CLI.
```
       Copilot vous demande de confirmer que vous approuvez les fichiers dans ce dossier.
```
Important

Pendant cette CLI de GitHub Copilot session, Copilot vous pouvez tenter de lire, de modifier et d’exécuter des fichiers dans et en dessous de ce dossier. Vous ne devez continuer que si vous faites confiance aux fichiers de cet emplacement. Pour plus d’informations sur les répertoires de confiance, consultez À propos de GitHub Copilot CLI.
Choisissez l’une des options suivantes :
```
       **1. Oui, continuer** :


       Copilot peut utiliser les fichiers dans cet emplacement uniquement pour cette session.


       **2. Oui et mémoriser ce dossier pour les sessions futures** :
```
Vous faites confiance aux fichiers de ce dossier pour cette session et les sessions futures. Vous ne serez plus sollicité à partir de ce dossier lorsque vous démarrez Copilot CLI. Choisissez cette option uniquement si vous êtes sûr qu’elle sera toujours sûre pour Copilot travailler avec des fichiers dans cet emplacement.
```
       **3. Non, quitter (Échap)**  :
```
Terminez votre Copilot CLI session.
Si vous n’êtes pas connecté à GitHub, vous serez invité à utiliser la commande slash /login. Entrez cette commande et suivez les instructions à l’écran pour vous authentifier.
Entrez un prompt dans l’interface de ligne de commande.

Il peut s’agir d’une question de conversation simple ou d’une demande d’exécution Copilot d’une tâche spécifique, telle que la résolution d’un bogue, l’ajout d’une fonctionnalité à une application existante ou la création d’une application.

Pour obtenir des exemples de prompts, consultez À propos de GitHub Copilot CLI.
Lorsque vous Copilot souhaitez utiliser un outil qui peut modifier ou exécuter des fichiers,par exemple, touch, chmod, node ou sed il vous demande d’approuver l’utilisation de l’outil.

Choisissez l’une des options suivantes :
```
       **1. Oui** :
```
Autorisez Copilot l’utilisation de cet outil. La prochaine fois Copilot que vous souhaitez utiliser cet outil, il vous demandera de l’approuver à nouveau.
```
       **2. Oui et approuver l’OUTIL pour le reste de la session en cours** :
```
Autorisez Copilot à utiliser cet outil, avec toutes les options, sans demander de nouveau, pour le reste de la session actuellement en cours. Toutes les demandes d’autorisation parallèles en attente du même type seront approuvées automatiquement. Vous devrez approuver les commandes dans les futures sessions.

Le choix de cette option est utile pour de nombreux outils, comme chmodcelui-ci, car il vous évite d’avoir à approuver des commandes similaires à plusieurs reprises dans la même session. Toutefois, tenez compte des implications de sécurité de cette option. Par exemple, le choix de cette option pour la commande rm permet Copilot de supprimer un fichier dans le répertoire actif ou ses sous-répertoires sans demander votre approbation.
```
       **3. Non, dites à Copilot quoi faire différemment (Échap)**


       Copilot n’exécute pas la commande. Au lieu de cela, il mettra fin à l’opération en cours et attendra votre prochain prompt. Vous pouvez indiquer Copilot à poursuivre la tâche, mais à l’aide d’une approche différente.
```
Par exemple, si vous demandez Copilot de créer un script bash, mais que vous ne souhaitez pas utiliser le script Copilot suggère, vous pouvez arrêter l’opération actuelle et entrer une nouvelle invite, par exemple : Continue the previous task but include usage instructions in the script.

Lorsque vous refusez une demande d’autorisation d’outil, vous pouvez également donner Copilot des commentaires inline sur le rejet afin qu’il puisse adapter son approche sans s’arrêter entièrement.

Conseils

Optimisez votre expérience avec Copilot CLI grâce aux conseils suivants.

Arrêter une opération en cours d’exécution

Si vous entrez une invite, puis décidez que vous souhaitez arrêter Copilot avant que la tâche soit terminée alors qu'elle est encore en train de « réfléchir », appuyez sur Échap.

Utiliser le mode plan

Le mode plan vous permet de collaborer avec Copilot un plan d’implémentation avant l’écriture d’un code. Appuyez sur Maj+Tab pour parcourir et sortir du mode plan.

Inclure un fichier spécifique dans votre prompt

Pour ajouter un fichier spécifique à votre prompt, utilisez @ suivi du chemin d’accès relatif au fichier. Par exemple, Explain @config/ci/ci-required-checks.yml ou Fix the bug in @src/app.js. Cela ajoute les contenus du fichier à votre invite de commande en tant que contexte pour Copilot.

Lorsque vous commencez à taper un chemin d’accès à un fichier, les chemins correspondants s’affichent sous la zone de prompt. Utilisez les touches fléchées pour sélectionner un chemin d’accès et appuyez sur Tab pour compléter le chemin d’accès dans votre prompt.

Travailler avec des fichiers situés à un autre emplacement

Pour effectuer une tâche, Copilot vous devrez peut-être travailler avec des fichiers qui se trouvent en dehors du répertoire de travail actuel. Si une invite que vous avez entrée dans une session interactive nécessite Copilot de modifier un fichier en dehors du répertoire actuel, elle vous demandera d’approuver l’accès au répertoire du fichier.

Vous pouvez également ajouter manuellement un répertoire de confiance à tout moment à l’aide de la commande à barre oblique :

/add-dir /path/to/directory

Si tous les fichiers que vous souhaitez utiliser se trouvent dans un autre emplacement, vous pouvez basculer le répertoire de travail actuel sans démarrer une nouvelle Copilot CLI session à l’aide des /cwd``/cd commandes ou des barres obliques :

/cwd /path/to/directory

Exécuter des commandes shell

Vous pouvez placer ! au début de votre entrée pour exécuter des commandes shell directement, sans appeler le modèle.

!git clone https://github.com/github/copilot-cli

Reprendre une session interactive

Vous pouvez utiliser l'option --resume de ligne de commande ou la commande /resume pour sélectionner et reprendre une session CLI interactive, ce qui vous permet de reprendre là où vous vous êtes arrêté, avec le contexte enregistré. Vous pouvez lancer une Copilot, agent de codage session sur GitHub, puis utiliser CLI de GitHub Copilot pour apporter cette session à votre environnement local.

Conseil

Pour reprendre rapidement la session locale la plus récemment fermée, entrez-la dans votre terminal :

copilot --continue

Utiliser des instructions personnalisées

Vous pouvez améliorer Copilotles performances en ajoutant des instructions personnalisées au référentiel dans lequel vous travaillez. Les instructions personnalisées sont des descriptions en langage naturel enregistrées dans des fichiers Markdown dans le référentiel. Elles sont automatiquement incluses dans les prompts que vous entrez lorsque vous travaillez dans ce référentiel. Cela permet Copilot de mieux comprendre le contexte de votre projet et comment répondre à vos invitations.

          Copilot CLI prend en charge :

Les instructions à l’échelle du référentiel dans le fichier .github/copilot-instructions.md.
Les fichiers d’instructions spécifiques au chemin d’accès : .github/instructions/**/*.instructions.md.
Les fichiers d’assistant tels que AGENTS.md.

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

Utilisez agents personnalisés.

A assistant personnalisé est une version spécialisée de Copilot. Agents personnalisés aide à Copilot gérer des flux de travail uniques, des conventions de codage particulières et des cas d’usage spécialisés.

          Copilot CLI inclut un groupe prédéfini de agents personnalisés pour les tâches courantes :

Agent	Description
Explorez	Effectue une analyse de base de code rapide, ce qui vous permet de poser des questions sur votre code sans ajouter à votre contexte principal.
Tâche	Exécute des commandes telles que des tests et des builds, en fournissant de brefs résumés sur la réussite et la sortie complète en cas d’échec.
Usage général	Gère les tâches complexes et multi-étapes qui nécessitent l’ensemble d’outils complet et le raisonnement de haute qualité, qui s’exécutent dans un contexte distinct pour garder votre conversation principale clairement axée.
Révision du code	Revoit les modifications en se concentrant uniquement sur la mise en évidence des problèmes authentiques, afin de réduire les distractions.

Le modèle IA utilisé par l’interface CLI peut choisir de déléguer une tâche à un sous-agent subsidiaire, qui fonctionne en utilisant un assistant personnalisé avec une expertise spécifique, s’il juge que cela entraînerait un accomplissement du travail de manière plus efficace. Le modèle peut tout aussi bien choisir de gérer le travail directement via l’agent principal.

Vous pouvez définir vos propres agents personnalisés fichiers Markdown, appelés profils d’agent, qui spécifient l’expertise que l’agent doit avoir, quels outils il peut utiliser et toutes les instructions spécifiques pour la façon dont il doit répondre.

Vous pouvez définir agents personnalisés au niveau de l’utilisateur, du référentiel ou de l’organisation/de l’entreprise :

Type	Lieu	Étendue
Niveau utilisateur assistant personnalisé	répertoire local `~/.copilot/agents`	Tous les projets
Niveau du référentiel assistant personnalisé

          `.github/agents` répertoire dans vos référentiels locaux et distants | Projet actif |

| Organisation et niveau Entreprise assistant personnalisé | Le répertoire /agents dans le dépôt .github-private d’une organisation ou d’une entreprise | Tous les projets sous votre organisation et compte d’entreprise |

Dans le cas de conflits d’affectation de noms, un agent au niveau du système remplace un agent au niveau du référentiel et l’agent au niveau du référentiel remplacerait un agent au niveau de l’organisation.

          Agents personnalisés peut être utilisé de trois façons :

Utilisation de la commande slash dans l'interface interactive du CLI pour effectuer une sélection dans la liste des éléments disponibles agents personnalisés:
```
/agent
```

Appel à assistant personnalisé directement dans une invite :

Use the refactoring agent to refactor this code block

        Copilot déduit automatiquement l’agent que vous souhaitez utiliser.

Spécification de l’option assistant personnalisé de ligne de commande que vous souhaitez utiliser. Par exemple:
```
copilot --agent=refactor-agent --prompt "Refactor this code block"
```

Pour plus d’informations, consultez « Création d’agents personnalisés pour Copilot, agent de codage ».

Utiliser les compétences

Vous pouvez créer des compétences pour améliorer la capacité d’effectuer Copilot des tâches spécialisées avec des instructions, des scripts et des ressources.

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

Ajouter un serveur MCP

          Copilot CLI est fourni avec le GitHub serveur MCP déjà configuré. Ce serveur MCP vous permet d’interagir avec les ressources sur GitHub.com, par exemple en fusionnant des pull requests à partir de l’interface CLI.

Pour étendre les fonctionnalités disponibles pour vous dans Copilot CLI, vous pouvez ajouter d'autres serveurs MCP.

Utilisez la commande à barre oblique suivante :
```
/mcp add
```
Renseignez les détails du serveur MCP que vous souhaitez ajouter, en utilisant la touche Tab pour passer d’un champ à l’autre.
Appuyez sur Ctrl+S pour enregistrer les détails.

Les détails de vos serveurs MCP configurés sont stockés dans le fichier mcp-config.json, situé par défaut dans le répertoire ~/.copilot. Cet emplacement peut être modifié en définissant la variable d’environnement COPILOT_HOME. Pour plus d’informations sur la structure JSON d’une définition de serveur, consultez Extension de l'agent de codage GitHub Copilot avec le protocole de contexte de modèle (MCP).

Gestion du contexte

          Copilot CLI fournit plusieurs commandes slash pour vous aider à surveiller et à gérer votre fenêtre de contexte :

* /usage: vous permet d’afficher vos statistiques de session, notamment :

Quantité de demandes Premium utilisées dans la session en cours
Durée de la session
Nombre total de lignes de code modifiées
Répartition de l’utilisation des jetons par modèle

        `/context`: fournit une vue d’ensemble visuelle de votre utilisation actuelle des jetons

        `/compact`: compresse manuellement votre historique des conversations pour libérer de l’espace contextuel

        CLI de GitHub Copilot compresse automatiquement votre historique en arrière-plan lorsque votre conversation approche de 95% de la limite de jetons, sans interrompre votre flux de travail.

Activer toutes les autorisations

Pour les situations où vous avez confiance en Copilot pour fonctionner sans restriction, vous pouvez utiliser les indicateurs --allow-all ou --yolo pour activer toutes les permissions à la fois.

Activer/désactiver l'affichage du raisonnement

          <kbd>Appuyez sur Ctrl</kbd>+<kbd>T</kbd> pour afficher ou masquer le processus de raisonnement du modèle pendant qu’il génère une réponse. Ce paramètre persiste entre les sessions, vous permettant d’observer comment Copilot résout des problèmes complexes.

En savoir plus

Pour obtenir la liste complète des options de ligne de commande et des commandes de barre oblique que vous pouvez utiliser avec Copilot CLI, effectuez l’une des opérations suivantes :

Entrez ? dans la zone de prompt lors d’une session interactive.
Entrez copilot help dans votre terminal.

Pour plus d’informations, utilisez l’une des commandes suivantes dans votre terminal :

```
        **Paramètres de configuration** :
```
copilot help config

Vous pouvez ajuster les paramètres de configuration en modifiant le fichier config.json, qui se trouve par défaut dans le répertoire ~/.copilot. Cet emplacement peut être modifié en définissant la variable d’environnement COPILOT_HOME.

        **Variables d’environnement** qui affectent Copilot CLI:

copilot help environment

        **Niveaux de journalisation disponibles** :

copilot help logging

        **Autorisations** pour autoriser ou refuser l’utilisation d’un outil :

copilot help permissions

Commentaires

Si vous avez des commentaires à propos de CLI de GitHub Copilot, veuillez nous en faire part en utilisant la commande à barre oblique /feedback dans une session interactive et en choisissant l’une des options. Vous pouvez remplir un questionnaire privé, soumettre un rapport de bogue ou suggérer une nouvelle fonctionnalité.

Prochaines étapes

          Copilot CLI peut fonctionner en tant qu’assistant conversationnel, répondre aux questions et vous aider à écrire du code de manière interactive. Au-delà de la conversation, Copilot CLI prend en charge une gamme de modes agentiques qui vous permettent de déléguer des tâches avec une plus grande autonomie.

Vous pouvez travailler avec des agents dans Copilot CLI pour soutenir un cycle de vie de tâche complet, de la délégation du travail à la révision des résultats :

        **Déléguer des tâches de manière autonome** : exécutez Copilot CLI en mode Autopilot pour effectuer des tâches à plusieurs étapes sans avoir besoin d’approbation à chaque étape. Consultez « [AUTOTITLE](/copilot/how-tos/copilot-cli/use-copilot-cli-agents/delegate-tasks-to-cca) ».

        **Appeler des agents personnalisés : appelez** des agents spécialisés adaptés à des tâches spécifiques, telles que la révision de code, la documentation ou les audits de sécurité. Consultez « [AUTOTITLE](/copilot/how-tos/copilot-cli/use-copilot-cli-agents/invoke-custom-agents) ».

        **Diriger les agents** : guidez et affinez le comportement de l’agent pendant l’exécution de la tâche pour assurer le suivi du travail. Voir [AUTOTITLE](/copilot/how-tos/copilot-cli/use-copilot-cli-agents/steer-agents).

        **Demandez une révision du code** : utilisez-la Copilot CLI pour obtenir une révision basée sur l’IA de vos modifications de code. Consultez « [AUTOTITLE](/copilot/how-tos/copilot-cli/use-copilot-cli-agents/agentic-code-review) ».

Lectures complémentaires

        [AUTOTITLE](/copilot/how-tos/copilot-cli/cli-best-practices)

        [AUTOTITLE](/copilot/reference/copilot-cli-reference/cli-command-reference)

        [AUTOTITLE](/copilot/reference/copilot-cli-reference/cli-config-dir-reference)

        [AUTOTITLE](/copilot/reference/copilot-cli-reference/acp-server)

Qui peut utiliser cette fonctionnalité ?

Dans cet article