- Saved searches
- Use saved searches to filter your results more quickly
- License
- cli/cli
- Name already in use
- Sign In Required
- Launching GitHub Desktop
- Launching GitHub Desktop
- Launching Xcode
- Launching Visual Studio Code
- Latest commit
- Git stats
- Files
- README.md
- About
- Take GitHub to the command line
- $ gh issue list gh pr status gh pr checkout gh pr create gh pr checks gh release create gh repo view gh alias set
Saved searches
Use saved searches to filter your results more quickly
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session.
GitHub’s official command line tool
License
cli/cli
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Name already in use
A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Sign In Required
Please sign in to use Codespaces.
Launching GitHub Desktop
If nothing happens, download GitHub Desktop and try again.
Launching GitHub Desktop
If nothing happens, download GitHub Desktop and try again.
Launching Xcode
If nothing happens, download Xcode and try again.
Launching Visual Studio Code
Your codespace will open once ready.
There was a problem preparing your codespace, please try again.
Latest commit
add gh cache to Actions explainer
Git stats
Files
Failed to load latest commit information.
README.md
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.
GitHub CLI is available for repositories hosted on GitHub.com and GitHub Enterprise Server 2.20+, and to install on macOS, Windows, and Linux.
If anything feels off, or if you feel that some functionality is missing, please check out the contributing page. There you will find instructions for sharing your feedback, building the tool locally, and submitting pull requests to the project.
If you are a hubber and are interested in shipping new commands for the CLI, check out our doc on internal contributions.
gh is available via Homebrew, MacPorts, Conda, Spack, and as a downloadable binary from the releases page.
Additional Conda installation options available on the gh-feedstock page.
- our Debian and RPM repositories;
- community-maintained repositories in various Linux distros;
- OS-agnostic package managers such as Homebrew, Conda, and Spack; and
- our releases page as precompiled binaries.
gh is available via WinGet, scoop, Chocolatey, Conda, and as downloadable MSI.
Note
The Windows installer modifies your PATH. When using Windows Terminal, you will need to open a new window for the changes to take effect. (Simply opening a new tab will not be sufficient.)
MSI installers are available for download on the releases page.
To add GitHub CLI to your codespace, add the following to your devcontainer file:
"features": < "ghcr.io/devcontainers/features/github-cli:1": <> >
GitHub CLI comes pre-installed in all GitHub-Hosted Runners.
Download packaged binaries from the releases page.
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.
About
GitHub’s official command line tool
Take GitHub to the command line
GitHub CLI brings GitHub to your terminal. Free and open source.
$ gh issue list gh pr status gh pr checkout gh pr create gh pr checks gh release create gh repo view gh alias set
View and filter a repository’s open issues.
Check on the status of your pull requests.
Check out pull requests locally.
Create a new pull request.
View your pull requests’ checks.
Create a shortcut for a gh command.
Showing 4 of 4 issues in cli/cli
#16 Improving interactions with protected branches
#14 PR commands on a detached head
#13 Support for GitHub Enterprise (enhancement)
#8 Add an easier upgrade command (bug)
Relevant pull requests in cli/cli
Current branch
There is no pull request associated with [fix-homepage-bug]
Created by you
You have no open pull requests
Requesting a code review from you
#100 Fix footer on homepage [fix-homepage-footer]
✓ Checks passing — Review pending
remote: Enumerating objects: 66, done.
remote: Counting objects: 100% (66/66), done.
remote: Total 83 (delta 66), reused 66 (delta 66), pack-reused 17
Unpacking objects: 100% (83/83), done.
From https://github.com/owner/repo
* [new ref] refs/pull/8896/head -> patch-2
M README.md
Switched to branch ‘patch-2’
Creating pull request for feature-branch into main in ampinsk/test
? Title My new pull request
? Body [(e) to launch vim, enter to skip]
? What’s next? Submit
http://github.com/owner/repo/pull/1
All checks were successful
1 failing, 3 successful, and 1 pending checks
— CodeQL 3m43s https://github.com/cli/cli/runs/123
✓ build (macos-latest) 4m18s https://github.com/cli/cli/runs/123
✓ build (ubuntu-latest) 1m23s https://github.com/cli/cli/runs/123
✓ build (windows-latest) 4m43s https://github.com/cli/cli/runs/123
× lint 47s https://github.com/cli/cli/runs/123
? Title GitHub CLI 1.0
? Release notes Write my own
? Is this a prerelease? No
? Submit? Publish release
https://github.com/octocat/.github/releases/tag/1.0
cli/cli
GitHub’s official command line tool
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.
Image: screenshot of gh pr status → https://user-images.githubusercontent.com/98482/84171218-327e7a80-aa40-11ea-8cd1-5177fc2d0e72.png
View this repository on GitHub: https://github.com/cli/cli
— Adding alias for bugs: issue list —label=»bugs»
✓ Added alias.
Showing 2 of 7 issues in cli/cli that match your search
#19 Pagination request returns empty JSON (bug)
#21 Error raised when passing valid parameters (bug)
gh issue list gh pr status gh pr checkout gh pr create gh pr checks gh release create gh repo view gh alias set