{"meta":{"title":"Démarrage rapide de l’interface CLI GitHub","intro":"Commencez à utiliser GitHub CLI pour travailler avec GitHub dans la ligne de commande.","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/quickstart","title":"Démarrage rapide"}],"documentType":"article"},"body":"# Démarrage rapide de l’interface CLI GitHub\n\nCommencez à utiliser GitHub CLI pour travailler avec GitHub dans la ligne de commande.\n\n## À propos de GitHub CLI\n\nGitHub CLI est un outil open source permettant d’utiliser GitHub à partir de la ligne de commande de votre ordinateur. Lorsque vous travaillez à partir de la ligne de commande, vous pouvez utiliser l’GitHub CLI pour gagner du temps et éviter de changer de contexte.\n\n## Prérequis\n\n1. Installez GitHub CLI sur macOS, Windows ou Linux. Pour en savoir plus, consultez [Installation](https://github.com/cli/cli?ref_product=cli\\&ref_type=engagement\\&ref_style=text#installation) dans le référentiel GitHub CLI.\n\n2. Pour vous authentifier sur GitHub, exécutez la commande suivante depuis votre terminal.\n\n   ```shell\n   gh auth login\n   ```\n\n3. Sélectionnez l'endroit où vous souhaitez vous authentifier :\n\n   * Si vous accédez à GitHub à GitHub.com, sélectionnez **GitHub.com**.\n   * Si vous accédez à GitHub sur un autre domaine, sélectionnez **Autre** , puis entrez votre nom d'hôte (par exemple : `octocorp.ghe.com`).\n\n4. Suivez les autres invites à l'écran.\n\n   GitHub CLI enregistre automatiquement vos identifiants Git lorsque vous choisissez HTTPS comme protocole préféré pour les opérations Git et que vous répondez « oui » à l'invite vous demandant si vous souhaitez vous authentifier sur Git avec vos identifiants GitHub. Ce procédé peut être utile car il vous permet d'utiliser les commandes Git telles que `git push` et `git pull`, sans avoir à configurer un gestionnaire d'informations d'identification distinct ou à utiliser SSH.\n\n## Quelques commandes utiles\n\n> \\[!NOTE]\n> Lorsque vous utilisez certaines commandes pour la première fois, par exemple `gh codespace SUBCOMMAND`, vous serez invité à ajouter des étendues supplémentaires à votre jeton d’authentification. Suivez les instructions qui s’affichent à l’écran.\n\n### Affichage de l’état\n\nSaisissez `gh status` pour voir les détails de votre travail actuel sur GitHub dans tous les référentiels auxquels vous êtes abonné.\n\n### Affichage d’un référentiel\n\nSaisissez `gh repo view OWNER/REPO` pour voir la description du référentiel et `README.md` pour le référentiel. Saisissez `gh repo view OWNER/REPO --web` pour afficher le référentiel dans votre navigateur par défaut.\n\nSi vous exécutez la sous-commande `repo` à partir du répertoire d’un référentiel Git local qui a un dépôt distant sur GitHub, vous pouvez omettre `OWNER/REPO`.\n\n### Clonage d’un dépôt\n\nEntrez `gh repo clone OWNER/REPO`. Par exemple, `gh repo clone octo-org/octo-repo` clone le référentiel `octo-org/octo-repo` dans le répertoire à partir duquel vous avez exécuté cette commande sur votre ordinateur local.\n\n### Création d'un dépôt\n\nSaisissez `gh repo create`, puis suivez les instructions à l’écran. Vous pouvez créer un nouveau référentiel vide sur GitHub puis, éventuellement, le cloner localement. Vous pouvez également envoyer un référentiel local existant vers GitHub, et, éventuellement, le définir comme le distant pour votre référentiel local. Pour plus d’informations sur la définition d’un répertoire local en tant que référentiel Git, consultez [Ajout de code hébergé localement dans GitHub](/fr/migrations/importing-source-code/using-the-command-line-to-import-source-code/adding-locally-hosted-code-to-github#initializing-a-git-repository).\n\n### Traitement des problèmes\n\nSaisissez `gh issue list --repo OWNER/REPO` pour afficher la liste des problèmes créés récemment qui sont actuellement ouverts pour le référentiel spécifié. Si vous exécutez la sous-commande `issue` à partir du répertoire d’un référentiel Git local qui a un dépôt distant sur GitHub, vous pouvez omettre `--repo OWNER/REPO`. Par exemple, saisissez `gh issue list --assignee \"@me\"` pour afficher la liste des problèmes qui vous ont été attribués dans ce référentiel, ou `gh issue list --author monalisa` pour afficher la liste des problèmes créés par l’utilisateur « monalisa ».\n\nVous pouvez également créer un problème, voir [Création d’un problème](/fr/issues/tracking-your-work-with-issues/creating-an-issue#creating-an-issue-with-github-cli) ou rechercher un problème, voir [Filtrage et recherche de problèmes et de demandes de tirage](/fr/issues/tracking-your-work-with-issues/filtering-and-searching-issues-and-pull-requests?tool=cli#searching-for-issues-and-pull-requests).\n\n### Traitement des demandes de tirage\n\nSaisissez `gh pr list --repo OWNER/REPO` pour afficher la liste des demandes de tirage créées récemment qui sont actuellement ouvertes pour le référentiel spécifié. Si vous exécutez la sous-commande `pr` à partir du répertoire d’un référentiel Git local qui a un dépôt distant sur GitHub, vous pouvez omettre `--repo OWNER/REPO`. Par exemple, saisissez `gh pr list --author \"@me\"` pour afficher la liste des demandes de tirage ouvertes que vous avez créées dans ce référentiel.\n\nSaisissez `gh pr list --label LABEL-NAME` pour afficher la liste des demandes de tirage ouvertes avec une étiquette spécifique. Saisissez `gh search prs --review-requested=@me --state=open` pour afficher la liste des demandes de tirage que vous avez été invité à réviser.\n\nPour créer une demande de tirage, saisissez `gh pr create` et suivez les instructions qui s’affichent à l’écran. Pour plus d’informations, consultez « [Création d’une pull request](/fr/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request?tool=cli#creating-the-pull-request) ».\n\n### Traitement des codespaces\n\nPour créer un nouveau codespace, saisissez `gh codespace create` et suivez les instructions qui s’affichent à l’écran.\n\nPour afficher vos codespaces existants, saisissez `gh codespace list`. Pour ouvrir un espace de code dans la version web de VS Code entrez `gh codespace code -w` et choisissez un espace de code.\n\nDans toutes ces commandes, vous pouvez remplacer `cs` par `codespace`.\n\n## Obtenir de l’aide\n\nSaisissez `gh` pour un rappel des commandes de premier niveau GitHub CLI que vous pouvez utiliser. Par exemple, `issue`, `pr`, `repo`, etc.\n\nPour chaque commande et chaque sous-commande auxiliaire, vous pouvez ajouter l’indicateur `--help` pour savoir comment elle est utilisée. Par exemple, `gh issue --help` ou `gh issue create --help`.\n\n## Personnalisation GitHub CLI\n\nVous pouvez modifier les paramètres de configuration et ajouter des alias ou des extensions pour que GitHub CLI fonctionne de la manière qui vous convient le mieux.\n\n* Saisissez `gh config set SUBCOMMANDS` pour configurer les paramètres de GitHub CLI, en remplaçant `SUBCOMMANDS` par le paramètre que vous souhaitez ajuster.\n\n  Par exemple, vous pouvez spécifier l’éditeur de texte utilisé lorsqu’une commande GitHub CLI vous oblige à modifier le texte, par exemple lorsque vous ajoutez le corps de texte à un nouveau problème que vous créez. Saisissez `gh config set editor \"code -w\"` pour définir votre éditeur de texte préféré sur Visual Studio Code. L’indicateur `-w` (ou `--wait`) dans cet exemple fait en sorte que la commande attende que le fichier soit fermé dans Visual Studio Code avant de passer à l’étape suivante dans votre terminal.\n\n  Pour plus d’informations, consultez [`gh config set`](https://cli.github.com/manual/gh_config_set).\n\n* Définissez des alias pour les commandes que vous exécutez couramment. Par exemple, si vous exécutez `gh alias set prd \"pr create --draft\"`, vous serez ainsi en mesure d’exécuter `gh prd` pour ouvrir rapidement un brouillon de demande de tirage. Pour plus d’informations, consultez [`gh alias`](https://cli.github.com/manual/gh_alias).\n\n* Créez ou ajoutez des commandes personnalisées avec les extensions GitHub CLI. Pour plus d’informations, consultez [Utilisation des extensions CLI GitHub](/fr/github-cli/github-cli/using-github-cli-extensions) et [Création d’extensions CLI GitHub](/fr/github-cli/github-cli/creating-github-cli-extensions).\n\n## Utilisation de GitHub CLI avec plusieurs comptes\n\nSi vous avez plusieurs comptes sur la même plateforme GitHub, par exemple GitHub.com, vous pouvez vous authentifier auprès de chacun d’eux et basculer entre eux à l’aide de la commande `gh auth switch`. Consultez [gh auth switch](https://cli.github.com/manual/gh_auth_switch) dans le manuel GitHub CLI.\n\nSi vous devez utiliser le GitHub CLI sur plusieurs plateformes GitHub, par exemple, un compte personnel sur GitHub.com et un compte d’utilisateur managé sur GHE.com, consultez [Utilisation de l’interface CLI GitHub sur plusieurs plateformes GitHub](/fr/github-cli/github-cli/using-multiple-accounts).\n\n## Pour aller plus loin\n\n* [Référence CLI GitHub](/fr/github-cli/github-cli/github-cli-reference)\n* [GitHub CLI le manuel en ligne](https://cli.github.com/manual/gh)"}