sitdraw

Как установить GitHub CLI (gh): вход, клон и PR из терминала

По официальным шагам установить GitHub CLI, пройти gh auth login и из терминала клонировать репозиторий или создать pull request.

Чтобы клонировать репозиторий или открыть pull request через GitHub CLI (команда gh), закройте три шага: официальная установка, gh auth login, затем gh repo clone или gh pr create.

Идите по cli.github.com, не угадывайте пакеты. Запросы: установить GitHub CLI, gh auth login, создать PR через gh. Документы: cli.github.com и cli.github.com/manual/.

ghОфициальное имя команды
authВход до вызовов API
PRСоздание из терминала

Поставить официальный бинарник под ОС

macOS и Windows

macOS: brew install gh. Windows: winget install --id GitHub.cli или Scoop / Chocolatey. Затем gh --version.

Linux

Debian / Ubuntu / Fedora — репозитории дистрибутива на cli.github.com. Не берите случайный сторонний deb. Если Homebrew закрыт — официальные пакеты релизов.

ШагКомандаНа что смотреть
Входgh auth logingithub.com или Enterprise; HTTPS или SSH; браузер или токен
Проверкаgh auth statusАккаунт, протокол, жив ли токен
Клонgh repo clone owner/repoЧастный репозиторий — права; SSO — отдельное согласие
PRgh pr createВетка запушена; --fill или заголовок и текст

Установка, вход, клон или PR

  1. 01
    Установить и сверить версию

    Менеджер пакетов со официальной страницы. gh --version должен напечатать версию. Нет команды — PATH. Не смешивать со старым сторонним gh.

  2. 02
    Запустить gh auth login

    GitHub.com (или Enterprise хост админа). HTTPS на каждый день; SSH, если ключ уже на аккаунте. С браузером: Login with a web browser, код на github.com/login/device. Без экрана: PAT.

  3. 03
    Клонировать один репозиторий

    В целевой папке gh repo clone owner/repo. Должен появиться .git. Частный клон падает — gh auth status и SSO.

  4. 04
    Создать PR с текущей ветки

    После push в корне: gh pr create. Заголовок и текст или gh pr create --fill. Открыть URL и проверить diff.

gh --version
gh auth login
gh auth status
gh repo clone owner/repo
cd repo
# После commit и push текущей ветки:
gh pr create --title "Fix login timeout" --body "Repro and fix."
Обязателен ли вход через браузер?
Нет. Мастер принимает personal access token. CI и хосты без экрана — токен или GH_TOKEN. Не коммитить.
HTTPS или SSH?
Если SSH-ключ GitHub уже на аккаунте — SSH. Иначе HTTPS; gh настроит помощник учётных данных.
pr create не находит репозиторий или отказывает?
Проверьте, что вы в git-репозитории, remote — GitHub, ветка запушена, есть право записи. Для SSO включите org на странице согласия.
Заменяет ли установка общую схему?
Нет. Клиент GitHub в терминале. Если встреча — та же схема, откройте sitdraw.

Сначала вход, потом репозиторий

Пока gh auth status не чистый, не считайте упавший clone аварией сети. Чаще аккаунт, SSO или протокол.

Начать картину