# Utilisation des extensions CLI GitHub

Découvrez comment utiliser des extensions personnalisées écrites par d’autres utilisateurs GitHub CLI.

## À propos des extensions GitHub CLI

> \[!NOTE]
> 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.

Les 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).

Les 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.

## Recherche d’extensions

Vous trouverez des extensions en parcourant [les dépôts ayant pour thème `gh-extension`](https://github.com/topics/gh-extension).

## Installation des extensions

Pour 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`.

Si 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.

Pour installer une extension dans le développement à partir du répertoire actif, utilisez `.` comme valeur pour le paramètre `repo`.

```shell
gh extension install REPO
```

Si 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`.

## Exécution d’une extension

Une 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`.
`EXTENSION-NAME` est le nom du dépôt qui contient l’extension, si l’on enlève le préfixe `gh-`.

Par exemple, si vous avez installé l’extension à partir du dépôt `octocat/gh-whoami`, vous pouvez l’exécuter avec la commande suivante :

```shell
gh whoami
```

En 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.

## Affichage des extensions installées

Pour afficher toutes les extensions installées, utilisez la sous-commande `extensions list`. La sortie vous indique également quelles extensions ont des mises à jour disponibles.

```shell
gh extension list
```

## Mise à jour des extensions

Pour mettre à jour une extension, utilisez la sous-commande `extensions upgrade`. Remplacez le paramètre `extension` par le nom de l’extension.

```shell
gh extension upgrade EXTENSION
```

Pour mettre à jour toutes les extensions installées, utilisez l’indicateur `--all`.

```shell
gh extension upgrade --all
```

## Désinstallation des extensions

Pour désinstaller une extension, utilisez la sous-commande `extensions remove`. Remplacez le paramètre `extension` par le nom de l’extension.

```shell
gh extension remove EXTENSION
```