GitHub CLI Setup

Configure gh CLI for GitHub access.

Check Current Status

gh auth status

Report one of these states:

• gh is not authenticated and needs login
• gh is authenticated, including the current username if available

Login Flow

If authentication is missing or broken, guide the user through:

gh auth login

Select: GitHub.com -> HTTPS -> Login with browser

Verify Authentication

gh auth status
gh api user --jq '.login'

Troubleshooting

If gh commands fail:

1. Check authentication - gh auth status
2. Re-login if needed - gh auth login
3. Check scopes - Ensure the token has repo access
4. Refresh auth - gh auth refresh
5. Update gh - brew upgrade gh or equivalent