Take GitHub to the command line
GitHub CLI brings GitHub to your terminal. Free and open source.
brew install gh$gh issue listgh pr statusgh pr checkoutgh pr creategh pr checksgh release creategh repo viewgh 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 new release.
View repository READMEs.
Create a shortcut for a gh command.
$
gh issue list
Showing 4 of 4 issues in cli/cli
#16Improving interactions with protected branches
#14PR commands on a detached head
#13Support for GitHub Enterprise (enhancement)
#8Add an easier upgrade command (bug)
Showing 4 of 4 issues in cli/cli
#16Improving interactions with protected branches
#14PR commands on a detached head
#13Support for GitHub Enterprise (enhancement)
#8Add an easier upgrade command (bug)
gh pr status
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
#100Fix footer on homepage[fix-homepage-footer]
✓ Checks passing- Review pending
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
#100Fix footer on homepage[fix-homepage-footer]
✓ Checks passing- Review pending
gh pr checkout 12
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'
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'
gh pr create
Creating pull request forfeature-branch intomain in ampinsk/test
? Title My new pull request
? Body [(e) to launch vim, enter to skip]
? What's next? Submit
https://github.com/owner/repo/pull/1
Creating pull request forfeature-branch intomain in ampinsk/test
? Title My new pull request
? Body [(e) to launch vim, enter to skip]
? What's next? Submit
https://github.com/owner/repo/pull/1
gh pr checks
All checks were successful
1 failing, 3 successful, and 1 pending checks
-CodeQL3m43shttps://github.com/cli/cli/runs/123
✓build (macos-latest)4m18shttps://github.com/cli/cli/runs/123
✓build (ubuntu-latest)1m23shttps://github.com/cli/cli/runs/123
✓build (windows-latest)4m43shttps://github.com/cli/cli/runs/123
×lint47shttps://github.com/cli/cli/runs/123
1 failing, 3 successful, and 1 pending checks
-CodeQL3m43shttps://github.com/cli/cli/runs/123
✓build (macos-latest)4m18shttps://github.com/cli/cli/runs/123
✓build (ubuntu-latest)1m23shttps://github.com/cli/cli/runs/123
✓build (windows-latest)4m43shttps://github.com/cli/cli/runs/123
×lint47shttps://github.com/cli/cli/runs/123
gh release create 1.0
? 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
? Release notes Write my own
? Is this a prerelease? No
? Submit? Publish release
https://github.com/octocat/.github/releases/tag/1.0
gh repo view
cli/cli
GitHub’s official command line tool
GitHub CLI
View this repository on GitHub: https://github.com/cli/cli
GitHub’s official command line tool
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 withgit 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
gh alias set bugs 'issue list --label="bugs"'
- Adding alias for bugs: issue list --label="bugs"
✓ Added alias.
$ gh bugs
Showing 2 of 7 issues in cli/cli that match your search
#19Pagination request returns empty JSON (bug)
#21Error raised when passing valid parameters (bug)
✓ Added alias.
$ gh bugs
Showing 2 of 7 issues in cli/cli that match your search
#19Pagination request returns empty JSON (bug)
#21Error raised when passing valid parameters (bug)
Goodbye, context switching. Hello, terminal.
Your entire GitHub workflow
Work with issues, pull requests, checks, releases and more.
View all GitHub CLI commands→Script and customize
Call the GitHub API to script almost any action, and set a custom alias for any command.
Learn about aliases and API→Enterprise-ready
Connect to GitHub Enterprise Server in addition to GitHub.com.
Get set up with Enterprise→Try GitHub on the command line
GitHub CLI brings GitHub to your terminal. Free and open source.
brew install ghor
