sitdraw

Installer et utiliser GitHub CLI (gh) : connexion, clone et PR dans le terminal

Installer GitHub CLI, terminer gh auth login, puis cloner un dépôt ou créer une pull request depuis le terminal.

Pour cloner ou ouvrir une pull request avec GitHub CLI (commande gh), trois étapes : installer par le canal officiel, gh auth login, puis gh repo clone ou gh pr create.

Suivre cli.github.com, ne pas inventer les paquets. Requêtes : installer GitHub CLI, gh auth login, créer une PR avec gh. Docs : cli.github.com et cli.github.com/manual/.

ghNom officiel de la commande
authConnexion avant l’API
PRCréer depuis le terminal

Installer le binaire officiel selon l’OS

macOS et Windows

macOS : brew install gh. Windows : winget install --id GitHub.cli, ou Scoop / Chocolatey. Puis gh --version.

Linux

Debian / Ubuntu / Fedora : dépôts sur cli.github.com. Pas de deb tiers au hasard. Si Homebrew est bloqué, paquets de release officiels.

ÉtapeCommandeÀ surveiller
Connexiongh auth logingithub.com ou Enterprise ; HTTPS ou SSH ; navigateur ou jeton
Vérifiergh auth statusCompte, protocole, jeton encore valable
Clonergh repo clone owner/repoDépôt privé : droits ; org SSO : autorisation en plus
PRgh pr createBranche poussée ; --fill ou titre/corps

Installer, se connecter, cloner ou ouvrir une PR

  1. 01
    Installer et confirmer la version

    Gestionnaire de paquets de la page officielle. gh --version doit afficher une version. Commande absente : PATH. Pas d’ancien script gh tiers.

  2. 02
    Lancer gh auth login

    GitHub.com (ou hôte Enterprise). HTTPS au quotidien ; SSH si une clé est déjà sur le compte. Navigateur : Login with a web browser, code sur github.com/login/device. Sans écran : PAT.

  3. 03
    Cloner un dépôt

    Dans le dossier cible : gh repo clone owner/repo. Un dossier .git doit apparaître. Échec privé : gh auth status et SSO.

  4. 04
    Créer une PR depuis la branche courante

    Après push, à la racine : gh pr create. Titre et corps, ou gh pr create --fill. Ouvrir l’URL et vérifier le diff.

gh --version
gh auth login
gh auth status
gh repo clone owner/repo
cd repo
# Après commit et push de la branche courante :
gh pr create --title "Fix login timeout" --body "Repro and fix."
La connexion navigateur est-elle obligatoire ?
Non. L’assistant accepte un personal access token. CI et hôtes sans écran : jeton ou GH_TOKEN. Ne pas le committer.
HTTPS ou SSH ?
Si une clé SSH GitHub est déjà sur le compte, choisir SSH. Sinon HTTPS ; gh configure l’assistant d’identifiants.
pr create ne trouve pas le dépôt ou refuse ?
Vérifier un dépôt git, un remote GitHub, une branche poussée, un droit d’écriture. Orgs SSO : activer l’org sur la page d’autorisation.
L’install remplace-t-elle un schéma partagé ?
Non. Client terminal. Si la réunion est le même schéma, ouvrir sitdraw.

Se connecter avant de toucher le dépôt

Tant que gh auth status n’est pas propre, ne pas traiter un clone raté comme une panne réseau. Souvent compte, SSO ou protocole.

Commencer le dessin