Utilisation de l'interface en ligne de commande GitHub Copilot (CLI)

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

Conditions préalables

Installez Copilot CLI. Consultez « AUTOTITLE ».

Utilisation de Copilot CLI

1. Dans votre terminal, accédez à un dossier qui contient le code que vous souhaitez utiliser.

2. Entrez pour démarrer Copilot CLI.

   Copilot vous demandera de confirmer que vous faites confiance aux fichiers contenus dans ce dossier.

   Important

   Pendant cette session GitHub Copilot CLI, Copilot peut tenter de lire, modifier et exécuter les fichiers contenus dans ce dossier et ses sous-dossiers. 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 AUTOTITLE.

3. Choisissez l’une des options suivantes :

   1. Oui, continuer :

   Copilot peut travailler avec les fichiers dans cet emplacement pour cette session seulement.

   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 interrogé lorsque vous lancerez Copilot CLI à partir de ce dossier. Choisissez cette option uniquement si vous êtes certain que Copilot peut toujours utiliser les fichiers de cet emplacement en toute sécurité.

   3. Non, quitter (Échap) :

   Mettez fin à votre session Copilot CLI.

4. Si vous n’êtes pas actuellement connecté à GitHub, vous serez invité à utiliser la commande à barre oblique . Entrez cette commande et suivez les instructions à l’écran pour vous authentifier.

5. Entrez un prompt dans l’interface de ligne de commande.

   Il peut s’agir d’une simple question de conversation ou d’une demande adressée à Copilot pour effectuer une tâche spécifique, telle que corriger un bogue, ajouter une fonctionnalité à une application existante ou créer une nouvelle application.

   Pour obtenir des exemples de prompts, consultez AUTOTITLE.

6. Lorsque Copilot souhaite utiliser un outil susceptible de modifier ou d’exécuter des fichiers (par exemple, touch, chmod, node ou sed), il vous demandera d’approuver l’utilisation de cet outil.

   Choisissez l’une des options suivantes :

   1. Oui :

   Autorisez Copilot à utiliser cet outil. La prochaine fois que Copilot voudra 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 à nouveau, pour le reste de la session 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 celui-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 autoriserait Copilot à supprimer un fichier dans le répertoire actif ou ses sous-répertoires sans demander votre approbation.

          **3. Non, et dites à Copilot quoi faire différemment (Esc)**
   

   Copilot n’exécutera pas la commande. Au lieu de cela, il mettra fin à l’opération en cours et attendra votre prochain prompt. Vous pouvez demander à Copilot de poursuivre la tâche, mais en utilisant 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 suggéré par Copilot, vous pouvez arrêter l’opération en cours et entrer un nouveau prompt, tel que : .

   Lorsque vous refusez une demande d’autorisation d’outil, vous pouvez également donner Copilot des commentaires en ligne sur le rejet de manière à ce 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 un prompt et décidez ensuite d’arrêter Copilot avant qu’il ne termine la tâche alors qu’il est encore en mode « Réflexion », appuyez sur Échap.

Utiliser le mode plan

Le mode plan vous permet de collaborer avec Copilot sur un plan d’implémentation avant l’écriture d’un code. Appuyez sur MajTab 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, ou . Cela ajoute le contenu du fichier à votre prompt 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 accomplir une tâche, Copilot peut avoir besoin de travailler avec des fichiers qui se trouvent en dehors du répertoire de travail actuel. Si un prompt que vous avez entré dans une session interactive nécessite que Copilot modifie un fichier en dehors de l’emplacement actuel, il 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 changer le répertoire de travail actuel sans démarrer une nouvelle session Copilot CLI en utilisant soit les commandes slash ou .

/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 de ligne de commande ou la commande 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 session Agent de programmation Copilot sur GitHub, puis utiliser GitHub Copilot CLI pour apporter cette session à votre environnement local.

copilot --continue

Utiliser des instructions personnalisées

Vous pouvez améliorer les performances de Copilot 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 aide Copilot à mieux comprendre le contexte de votre projet et à répondre à vos prompts.

Copilot CLI prend en charge :

• Les instructions à l’échelle du référentiel dans le fichier .
• Les fichiers d’instructions spécifiques au chemin d’accès : .
• Les fichiers d’assistant tels que .

Pour plus d’informations, consultez « AUTOTITLE ».

Utiliser agents personnalisés

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

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

Le modèle IA utilisé par l’interface CLI peut choisir de déléguer une tâche à un processus secondaire, qui fonctionne à l’aide d’un assistant personnalisé avec une expertise spécifique, s’il juge que cela entraînerait la réalisation du travail plus efficacement. Le modèle peut tout aussi bien choisir de gérer le travail directement via l’agent principal.

Vous pouvez définir votre propre agents personnalisés à l’aide de 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 :

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 sélectionner dans la liste des agents personnalisés disponibles :

  /agent
  

• Appeler directement assistant personnalisé dans une invite :

  Use the refactoring agent to refactor this code block
  

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

• Spécifiez le assistant personnalisé que vous souhaitez utiliser avec l’option de ligne de commande. Par exemple:

  copilot --agent=refactor-agent --prompt "Refactor this code block"
  

Pour plus d’informations, consultez « AUTOTITLE ».

Utiliser les compétences

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

Pour plus d’informations, consultez « AUTOTITLE ».

Ajouter un serveur MCP

Copilot CLI est fourni avec le serveur MCP GitHub déjà configuré. Ce serveur MCP vous permet d’interagir avec les ressources sur GitHub.com, par exemple en vous permettant de fusionner les demandes de tirage à partir de l’interface de ligne de commande.

Pour étendre les fonctionnalités disponibles dans Copilot CLI, vous pouvez ajouter d’autres serveurs MCP :

1. Utilisez la commande à barre oblique suivante :

   /mcp add
   

2. Renseignez les détails du serveur MCP que vous souhaitez ajouter, en utilisant la touche Tab pour passer d’un champ à l’autre.

3. Appuyez sur CtrlS pour enregistrer les détails.

Les détails de vos serveurs MCP configurés sont stockés dans le fichier , situé par défaut dans le répertoire . Cet emplacement peut être modifié en définissant la variable d’environnement . Pour plus d’informations sur la structure JSON d’une définition de serveur, consultez AUTOTITLE.

Gestion du contexte

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

• : 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

• : fournit une vue d’ensemble visuelle de votre utilisation actuelle des jetons

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

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

Activer toutes les autorisations

Dans les cas où vous faites confiance à Copilot pour s’exécuter sans restriction, vous pouvez utiliser les indicateurs ou pour activer toutes les autorisations simultanément.

Activer/désactiver l'affichage du raisonnement

Appuyez sur CtrlT 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, ce qui vous permet d’observer comment Copilot fonctionne via des problèmes complexes.

En savoir plus

Pour obtenir la liste complète des options de ligne de commande et des commandes à barre oblique que vous pouvez utiliser avec Copilot CLI, procédez de l’une des manières suivantes :

• Entrez dans la zone de prompt lors d’une session interactive.
• Entrez 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 , qui se trouve par défaut dans le répertoire . Cet emplacement peut être modifié en définissant la variable d’environnement .

• 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 GitHub Copilot CLI, 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 utiliser des agents dans Copilot CLI pour soutenir l'intégralité du cycle de vie d'une tâche, de la délégation du travail à l'examen 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 nécessiter d’approbation à chaque étape. Consultez « AUTOTITLE ».
• 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 ».
• 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.
• Demandez une révision du code : Utilisez Copilot CLI pour obtenir une révision basée sur l’IA de vos modifications de code. Consultez « AUTOTITLE ».

Lectures complémentaires

• AUTOTITLE
• AUTOTITLE
• AUTOTITLE