GitHub Copilot CLI : définition et périmètre

GitHub Copilot CLI désigne l’extension officielle gh-copilot qui s’installe par dessus la commande gh, le CLI GitHub historique. L’outil a quitté la beta en mars 2024 et fait désormais partie intégrante de l’offre Copilot incluse dans tous les plans payants sans surcoût. Le binaire pèse moins de 20 Mo et s’exécute hors connexion seulement pour la couche locale.

Le périmètre reste délibérément étroit. L’extension n’écrit pas de code source applicatif, ne refactore pas de fichiers et n’ouvre pas d’éditeur. Son terrain de jeu, c’est la ligne de commande : commandes bash, zsh, fish, PowerShell, git, docker, kubectl, awscli, terraform. Tout ce qui se tape dans un terminal entre dans son champ d’expertise.

Pour un panorama plus large des outils agentiques disponibles en 2026, consultez le pilier IA agentique. L’extension Copilot CLI s’y positionne comme un assistant de proximité, complémentaire des agents complets type Claude Code ou Cursor qui pilotent des workflows multi-fichiers.

Installation de l’extension gh copilot

L’installation se déroule en trois étapes. La première consiste à installer le CLI GitHub si vous ne l’avez pas déjà. Sur macOS, brew install gh règle la question en quinze secondes. Sur Ubuntu, le paquet officiel s’ajoute via le dépôt apt cli.github.com. Sur Windows, winget install –id GitHub.cli ou scoop install gh font le job.

La deuxième étape authentifie votre compte GitHub. La commande gh auth login lance un flow OAuth qui ouvre votre navigateur. Choisissez github.com comme hôte, HTTPS comme protocole, et autorisez l’application sur la page web qui s’affiche. Le token est stocké dans le keychain système et reste valide jusqu’à révocation manuelle.

La troisième étape ajoute l’extension Copilot à votre installation gh. Une seule commande suffit : gh extension install github/gh-copilot. Le binaire se télécharge depuis les releases GitHub et s’enregistre dans le répertoire des extensions de gh. La vérification se fait via gh copilot –version qui doit retourner un numéro de version sans erreur.

L’extension vérifie ensuite votre éligibilité Copilot à la première exécution. Si votre compte n’a pas de plan actif, un message vous redirige vers la page de souscription. Le plan Free de Copilot lancé en décembre 2024 suffit pour débloquer le CLI, mais avec un quota de 50 requêtes premium mensuelles partagées avec le chat IDE.

Commande gh copilot suggest en pratique

La commande gh copilot suggest transforme une description en langage naturel en commande shell exécutable. Le pattern le plus simple ressemble à gh copilot suggest “trouve les fichiers de plus de 100 Mo”. L’outil retourne find. -size +100M et propose trois actions : copier, exécuter ou modifier.

Le flag –type précise le contexte attendu. Trois valeurs sont possibles : shell pour les commandes Unix classiques, gh pour les sous-commandes du CLI GitHub lui-même, et git pour les opérations git. Cette typologie améliore la pertinence des suggestions et évite les croisements entre univers.

Un cas concret du quotidien : retrouver les branches git mergées pour les supprimer. La requête gh copilot suggest –type git “liste les branches mergées dans main” retourne la commande git branch –merged main filtrée par grep en une seconde. Le gain de temps versus la recherche manuelle sur Stack Overflow tourne autour de deux minutes par requête.

Une fois la commande générée, le menu interactif propose quatre options par les flèches : Copy command to clipboard envoie le texte vers le presse-papier système, Explain command lance un appel explain enchaîné, Execute command lance directement la commande dans le shell courant, Revise command relance une requête avec une instruction de modification.

Commande gh copilot explain pour décoder

La commande gh copilot explain fait l’opération inverse de suggest : elle transforme une commande shell complexe en explication détaillée en français ou en anglais selon votre locale. C’est l’outil idéal pour décortiquer une ligne croisée dans un script bash hostile ou un Dockerfile inconnu.

L’appel le plus fréquent ressemble à gh copilot explain “find. -type f -name log -mtime +30 -exec rm”. La réponse découpe la commande en six segments distincts : le binaire find, le point de départ, le filtre de type, le pattern de nom, le filtre temporel, l’action à exécuter. Chaque segment reçoit son explication, suivie d’un résumé global.

Le mode explain accepte aussi les pipelines complexes. Une commande type kubectl get pods pipée dans jq est décomposée en quatre étapes : la récupération des pods, le format JSON, le filtre jq sur le statut, l’extraction du nom. Le gain pédagogique est réel pour un junior qui découvre kubectl.

Pour comparer ce mode explain avec l’approche conversationnelle plus profonde de Claude Code, le guide comment utiliser Claude Code montre comment un agent CLI complet peut lire des fichiers entiers et tracer des dépendances. La logique reste différente : explain reste une lecture linéaire, l’agent fait de l’analyse contextuelle.

Aliases et raccourcis terminal utiles

Taper gh copilot suggest à chaque requête devient vite pénible. L’extension fournit une commande qui génère des aliases courts pour bash, zsh et PowerShell. La sortie de gh copilot alias — bash ajoute deux fonctions : ghcs pour suggest et ghce pour explain.

L’installation des aliases consiste à sourcer la sortie de la commande dans votre fichier de configuration shell. Sur bash, eval de la sortie redirigé vers ’/.bashrc rend les aliases persistants. Sur zsh, remplacer.bashrc par.zshrc. Sur fish, piper vers source et ajouter la ligne au fichier config.fish.

Un workflow courant combine les deux aliases. Vous tapez ghcs “renommer les fichiers.jpeg en.jpg”. La commande proposée utilise une boucle for avec mv. Avant de l’exécuter, vous lancez ghce sur la sortie pour comprendre la substitution de variable, puis vous exécutez en confiance.

Copilot CLI vs Claude Code CLI : que choisir

GitHub Copilot CLI et Claude Code CLI cohabitent sur le marché des assistants en ligne de commande mais ne jouent pas dans la même cour. Le premier reste un assistant ponctuel : une requête, une réponse, fin de l’interaction. Le second orchestre des sessions agentiques entières avec lecture de fichiers, écriture de code et exécution de tests.

Le bon réflexe consiste à installer les deux outils en parallèle. Copilot CLI reste à portée de doigts pour les opérations rapides de terminal. Claude Code se lance quand vous attaquez une feature qui touche plusieurs fichiers ou un debug en profondeur. La page Claude Code détaille les workflows agentiques exclusifs au CLI Anthropic.

Pour comparer avec d’autres alternatives premium, le guide Claude Code vs Cursor positionne ces trois acteurs sur leurs forces respectives. La grille tarifaire complète de l’offre Copilot figure dans GitHub Copilot prix avec le détail des plans Free, Pro, Business et Enterprise.

Limites, quotas et débogage courant

Les limites de Copilot CLI restent peu documentées officiellement. Les tests terrain confirment une longueur maximale de requête autour de 500 caractères pour suggest et 2 000 caractères pour explain. Au-delà, l’outil tronque silencieusement la requête et la qualité de réponse chute.

Le quota mensuel s’aligne sur celui de votre plan Copilot. Sur le plan Free, les 50 requêtes premium mensuelles sont partagées entre le chat IDE et le CLI. Un usage CLI quotidien épuise le quota en cinq jours. Sur le plan Pro à 10 $, les 300 requêtes mensuelles tiennent largement un mois normal pour un dev moyen.

Les erreurs courantes se concentrent sur trois symptômes. L’erreur HTTP 401 indique un token gh expiré : relancer gh auth login règle le problème. L’erreur HTTP 403 signale un quota épuisé ou un plan absent : vérifier l’état de l’abonnement sur github.com/settings/copilot. L’erreur HTTP 429 traduit un rate limit court terme : attendre quelques minutes suffit.

Le débogage en mode verbose s’active via le flag –debug sur chaque appel. La sortie dévoile l’URL appelée, le token tronqué et la latence. Pour un suivi structuré, rediriger stderr vers un fichier log permet d’analyser un comportement étrange a posteriori.

FAQ

GitHub Copilot CLI est-il payant ? Non, l’extension elle-même est gratuite. Elle nécessite cependant un plan Copilot actif, qui peut être le plan Free lancé en décembre 2024 ou n’importe quel plan payant à partir de 10 $/mois.

Quels shells sont supportés ? bash, zsh, fish, PowerShell et nushell sont officiellement supportés pour l’exécution des aliases. Le binaire gh copilot lui-même fonctionne sur n’importe quel shell capable de lancer le CLI gh.

Copilot CLI fonctionne-t-il sans connexion ? Non, chaque appel à suggest ou explain envoie la requête vers l’API GitHub. Aucune exécution locale du modèle n’est possible, contrairement à certaines solutions open source type Ollama.

Comment supprimer l’extension Copilot ? La commande gh extension remove gh-copilot désinstalle le binaire en gardant votre configuration gh intacte. Les aliases bash restent dans votre.bashrc et doivent être supprimés manuellement.

Le code envoyé au CLI est-il utilisé pour entraîner les modèles ? Non sur les plans Business et Enterprise par contrat. Sur Free et Pro, le toggle Allow GitHub to use my code snippets for product improvements est désactivé par défaut depuis 2024 et contrôle l’envoi des données au pool d’entraînement.