Cheatsheet GitHub CLI

gh auth login
gh auth status
gh auth token
gh auth refresh -s repo,read:org

Autenticar no GitHub.

gh config set editor vim
gh config set git_protocol ssh
gh config list
gh alias set co 'pr checkout'

Configurar preferências.

gh auth login --hostname github.com
gh auth switch
gh auth status --show-token

Gerir contas.

gh repo create meu-projeto --public
gh repo create --private --clone
gh repo create org/projeto --template base

Criar repos no GitHub.

gh repo clone user/repo
gh repo fork user/repo --clone
gh repo view --web

Obter repositórios.

gh repo list
gh repo list --language=php
gh repo view user/repo
gh repo set-default

Explorar repositórios.

gh repo edit --description "Nova desc"
gh repo rename novo-nome
gh repo delete user/repo --yes
gh repo archive user/repo

Modificar repositórios.

gh pr create
gh pr create --title "Fix bug" \
  --body "Descrição" --draft
gh pr create --base main --head feature

Criar pull request.

gh pr list
gh pr list --state merged
gh pr view 42
gh pr view 42 --web
gh pr diff 42

Explorar PRs.

gh pr checkout 42
gh pr merge 42 --squash
gh pr merge 42 --rebase
gh pr merge 42 --merge --delete-branch

Trabalhar com PRs.

gh pr review 42 --approve
gh pr review 42 --request-changes \
  --body "Corrigir X"
gh pr review 42 --comment
gh pr checks 42

Rever pull requests.

gh issue create
gh issue create --title "Bug" \
  --body "Descrição" --label bug
gh issue create --assignee @me

Criar issues.

gh issue list
gh issue list --label bug --state open
gh issue list --assignee @me
gh issue list --search "texto"

Filtrar issues.

gh issue view 10
gh issue close 10 --reason completed
gh issue reopen 10
gh issue edit 10 --add-label urgent
gh issue comment 10 --body "Feito!"

Modificar issues.

gh workflow list
gh workflow view ci.yml
gh run list --workflow=ci.yml
gh run list --limit 5

Ver workflows e runs.

gh run view 12345
gh run view 12345 --log
gh run view 12345 --log-failed
gh run watch 12345

Inspecionar execuções.

gh workflow run ci.yml
gh workflow run ci.yml -f param=val
gh run rerun 12345
gh run rerun 12345 --failed

Executar workflows.

gh run download 12345
gh run download 12345 -n artifact-name
gh cache list
gh cache delete --all

Descarregar resultados.

gh gist create ficheiro.txt --public
gh gist list
gh gist view GIST_ID
gh gist edit GIST_ID

Gerir gists.

gh release create v1.0.0
gh release create v1.0.0 dist/* \
  --title "Release 1.0" \
  --notes "Changelog aqui"
gh release list
gh release download v1.0.0

Gerir releases.

gh api repos/user/repo
gh api graphql -f query='{ viewer { login } }'
gh api repos/user/repo/issues \
  --paginate --jq '.[].title'

Aceder à API do GitHub.

gh extension install dlvhdr/gh-dash
gh extension list
gh extension remove gh-dash
gh dash  # dashboard TUI

Estender com extensões.