---
name: GitHub CLI Setup
slug: github-cli-setup
category: DevOps
description: GitHub CLI Setup helps check and repair gh authentication for GitHub access. Use it to verify login status, sign in, refresh scopes, or troubleshoot connection failures.
github: "https://github.com/fcakyon/claude-codex-settings/tree/main/plugins/github-dev/skills/setup"
language: Python
stars: 1086
forks: 102
install: "npx degit https://github.com/fcakyon/claude-codex-settings/tree/main/plugins/github-dev/skills/setup ~/.claude/skills/setup"
installs_to: ~/.claude/skills/setup
source_path: plugins/github-dev/skills/setup/SKILL.md
collection_size: 25
category_size: 798
collection_url: "https://dirskills.com/collections/fcakyon/claude-codex-settings"
added: 2026-08-20T07:56:47.673Z
last_synced: 2026-08-20T07:56:47.673Z
canonical_url: "https://dirskills.com/skills/github-cli-setup"
---

# GitHub CLI Setup

GitHub CLI Setup helps check and repair gh authentication for GitHub access. Use it to verify login status, sign in, refresh scopes, or troubleshoot connection failures.

**Install:**

```bash
npx degit https://github.com/fcakyon/claude-codex-settings/tree/main/plugins/github-dev/skills/setup ~/.claude/skills/setup
```

## README

# GitHub CLI Setup

Configure `gh` CLI for GitHub access.

## Check Current Status

```bash
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:

```bash
gh auth login
```

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

## Verify Authentication

```bash
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