cli
GitHub CLI #
gh is GitHub on the command line. It brings pull requests, issues, and other GitHub concepts to the terminal next to where you are already working with git and your code.
Availability #
GitHub CLI is available for repositories hosted on GitHub.com and GitHub Enterprise Server 2.20+, and to install on macOS, Windows, and Linux.
Documentation #
Read the official docs for usage and more information.
We want your feedback #
We’d love to hear your feedback about gh. If you spot bugs or have features that you’d really like to see in gh, please check out the contributing page.
Installation #
macOS #
gh is available via Homebrew and MacPorts.
Homebrew #
| Install: | Upgrade: |
|---|---|
brew install gh | brew upgrade gh |
MacPorts #
| Install: | Upgrade: |
|---|---|
sudo port install gh | sudo port selfupdate && sudo port upgrade gh |
Linux #
Windows #
gh is available via scoop, Chocolatey, and as downloadable MSI.
scoop #
Install:
scoop bucket add github-gh https://github.com/cli/scoop-gh.git
scoop install gh
Upgrade:
scoop update gh
Chocolatey #
| Install: | Upgrade: |
|---|---|
choco install gh | choco upgrade gh |
Signed MSI #
MSI installers are available for download on the releases page.
Other platforms #
Download packaged binaries from the releases page.
Build from source #
See here on how to build GitHub CLI from source.
Comparison with hub #
For many years, hub was the unofficial GitHub CLI tool. gh is a new project that helps us explore
what an official GitHub CLI tool can look like with a fundamentally different design. While both
tools bring GitHub to the terminal, hub behaves as a proxy to git, and gh is a standalone
tool. Check out our more detailed explanation to learn more.