Question 1

How do I install the gh CLI?

Accepted Answer

On macOS, use brew install gh. On Windows, use winget install GitHub.cli or choco install gh. On Linux, use your distribution's package manager or download directly from the official releases page.

Question 2

How to create a PR to a non-default branch?

Accepted Answer

Use the --base flag: gh pr create --base [target-branch]. For example, to create a PR to the develop branch, use gh pr create --base develop.

Question 3

How to manage multiple repositories with gh?

Accepted Answer

Most gh commands accept the -R or --repo flag to specify a repository. Example: gh issue list -R owner/repo. You can manage issues and PRs from other repositories even if you're not in a git directory.

Question 4

What can I do with gh api?

Accepted Answer

gh api allows you to directly call GitHub REST API and GraphQL API. Features not directly supported by gh commands can be accessed through the API. For example, gh api /user fetches current user info, and gh api repos/{owner}/{repo}/topics gets repository topics.

Command	Description
`gh auth login`	Login to GitHub
`gh auth logout`	Logout
`gh auth status`	Check auth status
`gh auth refresh`	Refresh auth token
`gh auth switch`	Switch account

Command	Description
`gh repo create [name]`	Create new repository
`gh repo clone [repo]`	Clone repository
`gh repo fork [repo]`	Fork repository
`gh repo view`	View repository info
`gh repo view --web`	Open in browser
`gh repo list [user]`	List repositories
`gh repo delete [repo]`	Delete repository
`gh repo rename [new-name]`	Rename repository

Command	Description
`gh issue list`	List issues
`gh issue create`	Create issue (interactive)
`gh issue create -t "[title]" -b "[body]"`	Create issue (inline)
`gh issue view [number]`	View issue details
`gh issue close [number]`	Close issue
`gh issue reopen [number]`	Reopen issue
`gh issue edit [number]`	Edit issue
`gh issue comment [number] -b "[body]"`	Add comment to issue

Command	Description
`gh pr list`	List PRs
`gh pr create`	Create PR (interactive)
`gh pr create -t "[title]" -b "[body]"`	Create PR (inline)
`gh pr view [number]`	View PR details
`gh pr checkout [number]`	Checkout PR branch
`gh pr merge [number]`	Merge PR
`gh pr merge --squash`	Squash and merge
`gh pr merge --rebase`	Rebase and merge
`gh pr close [number]`	Close PR
`gh pr review [number]`	Review PR
`gh pr diff [number]`	View PR diff

Command	Description
`gh run list`	List workflow runs
`gh run view [run-id]`	View run details
`gh run watch [run-id]`	Watch run progress
`gh run rerun [run-id]`	Rerun workflow
`gh run cancel [run-id]`	Cancel run
`gh run download [run-id]`	Download artifacts
`gh workflow list`	List workflows
`gh workflow run [workflow]`	Manually run workflow
`gh workflow enable [workflow]`	Enable workflow
`gh workflow disable [workflow]`	Disable workflow

GitHub CLI Cheatsheet

#Authentication

#Repository

#Issues

#Pull Request

#GitHub Actions

#Releases

#Gist

#Search

#API & Others

#Frequently Asked Questions

Command	Description
`gh release list`	List releases
`gh release create [tag]`	Create release
`gh release create [tag] --generate-notes`	Auto-generate release notes
`gh release view [tag]`	View release details
`gh release download [tag]`	Download release assets
`gh release upload [tag] [files]`	Upload assets
`gh release delete [tag]`	Delete release

Command	Description
`gh gist list`	List gists
`gh gist create [file]`	Create gist
`gh gist create --public [file]`	Create public gist
`gh gist view [id]`	View gist
`gh gist edit [id]`	Edit gist
`gh gist clone [id]`	Clone gist
`gh gist delete [id]`	Delete gist

Command	Description
`gh search repos [query]`	Search repositories
`gh search issues [query]`	Search issues
`gh search prs [query]`	Search PRs
`gh search code [query]`	Search code
`gh search commits [query]`	Search commits

Command	Description
`gh api [endpoint]`	Call GitHub API
`gh api graphql -f query="..."`	GraphQL query
`gh browse`	Open current repo in browser
`gh browse [file]`	Open file in browser
`gh alias set [alias] "[command]"`	Set command alias
`gh extension list`	List extensions
`gh extension install [repo]`	Install extension