gh-auth

Login to GitHub

$ gh auth login

$ gh auth login --hostname [github.example.com]

$ gh auth status

$ gh auth logout

$ gh auth refresh

gh auth command [options]

gh auth manages authentication for the GitHub CLI. It handles OAuth device flow, personal access tokens, and SSH key authentication across multiple GitHub hosts.
The command stores credentials securely in the system keychain when available, falling back to encrypted file storage. It supports github.com and GitHub Enterprise Server instances simultaneously.
gh auth provides the foundation for all authenticated gh operations.

login

Authenticate with a GitHub host.

Log out of a GitHub host.

View authentication status.

Refresh stored credentials.

Print authentication token.

GitHub hostname (for Enterprise).

Open browser for authentication.

Read token from stdin.

Display help information.

~/.config/gh/hosts.yml

Stores authentication tokens and host-specific settings for each GitHub instance.

Token scopes affect available commands. Enterprise instances may require SSO authentication. Credentials stored in keychain or config file.

gh auth is part of the GitHub CLI, providing secure authentication workflows designed for both interactive and scripted use cases.

gh(1), gh-config(1)