{"meta":{"title":"Utilisation des extensions CLI GitHub","intro":"Découvrez comment utiliser des extensions personnalisées écrites par d’autres utilisateurs GitHub CLI.","product":"GitHub CLI","breadcrumbs":[{"href":"/fr/github-cli","title":"GitHub CLI"},{"href":"/fr/github-cli/github-cli","title":"Interface CLI de GitHub"},{"href":"/fr/github-cli/github-cli/using-github-cli-extensions","title":"Utilisation des extensions CLI GitHub"}],"documentType":"article"},"body":"# Utilisation des extensions CLI GitHub\n\nDécouvrez comment utiliser des extensions personnalisées écrites par d’autres utilisateurs GitHub CLI.\n\n## À propos des extensions GitHub CLI\n\n> \\[!NOTE]\n> Les extensions en dehors de GitHub et GitHub CLI ne sont pas certifiées par GitHub et sont régies par des conditions d’utilisation distinctes, une politique de confidentialité et une documentation de support. Pour atténuer les risques lors de l’utilisation d’extensions tierces, auditez le code source de l’extension avant d’installer ou de mettre à jour l’extension.\n\nLes extensions GitHub CLI sont des commandes GitHub CLI personnalisées que tout le monde peut créer et utiliser. Pour plus d’informations sur la création d’extensions GitHub CLI, consultez [Création d’extensions CLI GitHub](/fr/github-cli/github-cli/creating-github-cli-extensions).\n\nLes extensions sont installées localement et sont limitées à l'utilisateur. Par conséquent, si vous accédez à GitHub CLI à partir d’un autre ordinateur ou qu’un autre utilisateur accède à GitHub CLI à partir de la même machine, l’extension ne sera pas disponible.\n\n## Recherche d’extensions\n\nVous trouverez des extensions en parcourant [les dépôts ayant pour thème `gh-extension`](https://github.com/topics/gh-extension).\n\n## Installation des extensions\n\nPour installer une extension, utilisez la sous-commande `extensions install`. Remplacez le paramètre `repo` par le référentiel de l’extension. Vous pouvez utiliser l’URL complète, telle que `https://github.com/octocat/gh-whoami`, ou simplement le propriétaire et le référentiel, comme `octocat/gh-whoami`.\n\nSi le propriétaire et le référentiel sont utilisés, `gh` installe l’extension à l’aide du nom d’hôte auquel `gh` est actuellement authentifié. Le format d’URL complet est utile lors de l’installation d’extensions à partir d’un autre hôte. Par exemple, les utilisateurs sur GitHub Enterprise Server doivent utiliser l’URL de référentiel complète pour installer des extensions à partir de GitHub.com ou d’un autre hôte.\n\nPour installer une extension dans le développement à partir du répertoire actif, utilisez `.` comme valeur pour le paramètre `repo`.\n\n```shell\ngh extension install REPO\n```\n\nSi vous disposez déjà d’une extension portant le même nom, la commande échoue. Par exemple, si vous avez installé `octocat/gh-whoami`, vous devez le désinstaller avant d’installer `hubot/gh-whoami`.\n\n## Exécution d’une extension\n\nUne fois que vous avez installé une extension, vous l’exécutez comme vous le feriez pour une commande GitHub CLI native, à l’aide de `gh EXTENSION-NAME`.\n`EXTENSION-NAME` est le nom du dépôt qui contient l’extension, si l’on enlève le préfixe `gh-`.\n\nPar exemple, si vous avez installé l’extension à partir du dépôt `octocat/gh-whoami`, vous pouvez l’exécuter avec la commande suivante :\n\n```shell\ngh whoami\n```\n\nEn règle générale, vous trouverez des informations spécifiques sur l’utilisation d’une extension dans le fichier LISEZMOI du dépôt qui la contient.\n\n## Affichage des extensions installées\n\nPour afficher toutes les extensions installées, utilisez la sous-commande `extensions list`. La sortie vous indique également quelles extensions ont des mises à jour disponibles.\n\n```shell\ngh extension list\n```\n\n## Mise à jour des extensions\n\nPour mettre à jour une extension, utilisez la sous-commande `extensions upgrade`. Remplacez le paramètre `extension` par le nom de l’extension.\n\n```shell\ngh extension upgrade EXTENSION\n```\n\nPour mettre à jour toutes les extensions installées, utilisez l’indicateur `--all`.\n\n```shell\ngh extension upgrade --all\n```\n\n## Désinstallation des extensions\n\nPour désinstaller une extension, utilisez la sous-commande `extensions remove`. Remplacez le paramètre `extension` par le nom de l’extension.\n\n```shell\ngh extension remove EXTENSION\n```"}