github

name	github
description	GitHub CLI - manage repositories, issues, pull requests, actions, releases, and more from the command line.

GitHub CLI Skill

Use the gh CLI to interact with GitHub repositories and services.

Authentication

Check auth status:

gh auth status

Login:

gh auth login

Refresh token:

gh auth refresh

Repositories

Clone repository:

gh repo clone owner/repo

Create new repo:

gh repo create my-repo --public --source=. --push

Fork repository:

gh repo fork owner/repo --clone

View repo in browser:

gh repo view --web

List your repos:

gh repo list

Issues

List issues:

gh issue list

Create issue:

gh issue create --title "Bug: Login fails" --body "Description here"

Create issue interactively:

gh issue create

View issue:

gh issue view 123

Close issue:

gh issue close 123

Reopen issue:

gh issue reopen 123

Comment on issue:

gh issue comment 123 --body "Working on this"

Assign issue:

gh issue edit 123 --add-assignee @me

Add labels:

gh issue edit 123 --add-label "bug,priority:high"

Pull Requests

List PRs:

gh pr list

Create PR:

gh pr create --title "Add feature" --body "Description"

Create PR from current branch:

gh pr create --fill

View PR:

gh pr view 45

View PR in browser:

gh pr view 45 --web

Checkout PR locally:

gh pr checkout 45

Review PR:

gh pr review 45 --approve
gh pr review 45 --request-changes --body "Please fix X"
gh pr review 45 --comment --body "Looks good but..."

Merge PR:

gh pr merge 45 --squash
gh pr merge 45 --merge
gh pr merge 45 --rebase

Close PR:

gh pr close 45

List PR checks:

gh pr checks 45

View PR diff:

gh pr diff 45

Actions (CI/CD)

List workflow runs:

gh run list

View run details:

gh run view 12345

Watch run in progress:

gh run watch 12345

View run logs:

gh run view 12345 --log

Rerun failed jobs:

gh run rerun 12345 --failed

List workflows:

gh workflow list

Run workflow manually:

gh workflow run deploy.yml

Run with inputs:

gh workflow run deploy.yml -f environment=production

Disable/enable workflow:

gh workflow disable deploy.yml
gh workflow enable deploy.yml

Releases

List releases:

gh release list

Create release:

gh release create v1.0.0 --title "Version 1.0" --notes "Release notes"

Create from tag:

gh release create v1.0.0 --generate-notes

Upload assets:

gh release upload v1.0.0 ./dist/app.zip

Download assets:

gh release download v1.0.0

Delete release:

gh release delete v1.0.0

Gists

Create gist:

gh gist create file.txt --public

Create from stdin:

echo "Hello" | gh gist create -

List gists:

gh gist list

View gist:

gh gist view GIST_ID

Edit gist:

gh gist edit GIST_ID

Search

Search repos:

gh search repos "react hooks" --limit 10

Search issues:

gh search issues "bug authentication" --repo owner/repo

Search PRs:

gh search prs "fix memory leak" --state open

Search code:

gh search code "function handleAuth" --repo owner/repo

API

Make API request:

gh api repos/owner/repo

POST request:

gh api repos/owner/repo/issues -f title="New issue" -f body="Description"

GraphQL query:

gh api graphql -f query='{ viewer { login } }'

Paginate results:

gh api repos/owner/repo/issues --paginate

Labels

List labels:

gh label list

Create label:

gh label create "priority:high" --color FF0000 --description "High priority"

Projects

List projects:

gh project list

View project:

gh project view 1

SSH Keys

List SSH keys:

gh ssh-key list

Add SSH key:

gh ssh-key add ~/.ssh/id_ed25519.pub --title "My laptop"

GPG Keys

List GPG keys:

gh gpg-key list

Add GPG key:

gh gpg-key add key.gpg

Secrets (for Actions)

List secrets:

gh secret list

Set secret:

gh secret set MY_SECRET

Set from file:

gh secret set MY_SECRET < secret.txt

Delete secret:

gh secret delete MY_SECRET

Variables (for Actions)

List variables:

gh variable list

Set variable:

gh variable set MY_VAR --body "value"

Extensions

List installed extensions:

gh extension list

Install extension:

gh extension install owner/gh-extension

Browse extensions:

gh extension browse

Aliases

Create alias:

gh alias set pv 'pr view'

List aliases:

gh alias list

Configuration

View config:

gh config list

Set default editor:

gh config set editor vim

Set default browser:

gh config set browser "open"

Common Workflows

Quick PR workflow:

# Create branch, commit, push, create PR
git checkout -b feature/my-feature
# ... make changes ...
git add . && git commit -m "Add feature"
git push -u origin feature/my-feature
gh pr create --fill

Review and merge:

gh pr checkout 45
# ... review code ...
gh pr review --approve
gh pr merge --squash --delete-branch

Check CI status:

gh pr checks
gh run watch