Example use:

gh auth --host github.com

As I see it, these would be its broader set of features:

• triggers authentication for a specific GitHub host and caches credentials to hosts.yml

  • supports Device Authorization Flow Additional or alternative authentication method #297 (comment)
  • provide ability to paste in an authentication token obtained elsewhere
  • nice-to-have: also configures your git credential handler
  • nice-to-have: also configures your preferred git clone protocol for this host

• verifies current credentials (either that from GITHUB_TOKEN or from hosts.yml)

• offers way to re-auth No CTA after mistaken deletion of oauth access #627 How to switch user aka. logout and sign in? #887

  • offer a way to ask for additional OAuth scopes (for Gist or gh api purposes)

• longer-term: support multiple logged-in accounts to the same host Allow multiple account credentials #326

Subcommands:

• login gh auth login #1445
• refresh gh auth refresh #1501
• status auth status #1495
• logout auth logout #1491

/cc @ampinsk