GitHub CLI Commands

Quick reference for GitHub CLI operations.

Authentication

• gh auth login - interactive login
• gh auth login --web - login via browser
• gh auth logout - logout
• gh auth status - check status
• gh auth token - print token

Repository Operations

Create & Clone

• gh repo create - interactive create
• gh repo create <name> --public - create public
• gh repo create <name> --private - create private
• gh repo create <name> --clone - create + clone
• gh repo clone <owner/repo> - clone repo
• gh repo fork - fork current
• gh repo fork --clone - fork + clone

View & List

• gh repo view - view current repo
• gh repo view --web - open in browser
• gh repo list - list your repos
• gh repo list <owner> - list user/org repos

Issue Management

Create Issues

• gh issue create - interactive create
• gh issue create --title "T" - with title
• gh issue create --title "T" --body "B" - with title + body
• gh issue create --label bug - with label
• gh issue create --assignee @me - assign to self

List & View

• gh issue list - list open
• gh issue list --state closed - list closed
• gh issue list --state all - list all
• gh issue list --label bug - filter by label
• gh issue list --assignee @me - assigned to me
• gh issue view <n> - view issue
• gh issue view <n> --web - open in browser

Update & Close

• gh issue edit <n> --title "New" - update title
• gh issue edit <n> --add-label bug - add label
• gh issue close <n> - close
• gh issue reopen <n> - reopen
• gh issue comment <n> --body "msg" - add comment

Pull Request Workflows

Create PRs

• gh pr create - interactive create
• gh pr create --title "T" - with title
• gh pr create --draft - as draft
• gh pr create --base main - set target branch
• gh pr create --assignee @me - assign to self
• gh pr create --reviewer user - request review
• gh pr create --fill - auto-fill from commits

List & View

• gh pr list - list open
• gh pr list --state merged - list merged
• gh pr list --state all - list all
• gh pr list --author @me - by me
• gh pr view - view current branch PR
• gh pr view <n> - view specific
• gh pr view <n> --web - open in browser

Review & Checkout

• gh pr checkout <n> - checkout PR branch
• gh pr review --approve - approve
• gh pr review --request-changes - request changes
• gh pr review --comment - comment
• gh pr diff - view diff

Merge & Close

• gh pr merge - merge current
• gh pr merge --squash - squash + merge
• gh pr merge --rebase - rebase + merge
• gh pr merge --auto - enable auto-merge
• gh pr merge --delete-branch - delete branch after
• gh pr close <n> - close (no merge)

Status & Checks

• gh pr status - PR status
• gh pr checks - view CI checks
• gh pr checks --watch - watch progress

Release Management

Create Releases

• gh release create <tag> - create release
• gh release create v1.0.0 - with version tag
• gh release create <tag> --title "T" - with title
• gh release create <tag> --notes "N" - with notes
• gh release create <tag> --draft - as draft
• gh release create <tag> --generate-notes - auto-generate
• gh release create <tag> file.zip - upload assets

List & View

• gh release list - list releases
• gh release view <tag> - view details
• gh release view --web - open in browser
• gh release download <tag> - download assets

Edit & Delete

• gh release edit <tag> --title "New" - update title
• gh release edit <tag> --draft=false - publish draft
• gh release delete <tag> - delete

GitHub Actions

Workflows

• gh workflow list - list workflows
• gh workflow view <name> - view details
• gh workflow run <name> - trigger
• gh workflow run <name> --ref main - run on branch

Runs

• gh run list - list recent
• gh run list --workflow <name> - filter by workflow
• gh run view <id> - view details
• gh run view <id> --log - view logs
• gh run watch <id> - watch progress
• gh run rerun <id> - rerun
• gh run cancel <id> - cancel

Search

• gh search repos <query> - search repos
• gh search repos "language:go" - by language
• gh search issues <query> - search issues
• gh search prs <query> - search PRs
• gh search code <query> - search code

Configuration

• gh config set editor vim - set editor
• gh config set git_protocol ssh - set protocol
• gh config list - list settings

Extensions

• gh extension list - list installed
• gh extension install <repo> - install
• gh extension upgrade <name> - upgrade
• gh extension remove <name> - remove