Archived now that GitHub has released their own CLI
A plugin for the fish-shell.
Navigate to the GitHub pages for your branches from the command line! Say that you are working with a remote repository called Repo
that is owned by Org
. And you are on a branch called branch
for which a PR has been created with id 32
. github.fish
provides a shortcut to open the current branch's
- pull request page (https://github.com/Org/Repo/pull/32)
- tree view (https://github.com/Org/Repo/tree/branch)
in your browser. Should work on macOS and Linux.
If you only want to be able to open the tree view for the current branch on GitHub, you only need to install the plugin.
With fisher
fisher add patrickf1/github.fish
With Oh My Fish
omf install https://github.com/patrickf1/github.fish
If you want to be able to open the pull request created for the current branch on GitHub, you will need to do a bit more set up. The first step is to obtain a GitHub Personal Access token and set it as an environment variable. This is needed because github.fish
queries the GitHub API to get information about your repositories' pull requests. See the section below for further instructions. The second is to install gron, which is used to parse the JSON returned by GitHub's API:
brew install gron
Follow GitHub's directions for creating a personal access token here. These are the minimal permissions the token will need:
![]() |
If you work with repositories protected by SSO, make sure you follow step 10. Or see the directions here.
After you have obtained a token, assign it to the environment variable GITHUB_AUTH_TOKEN
like so in your config.fish
(or similar) so that github.fish
can access it:
set -x GITHUB_AUTH_TOKEN <insert token here>
The github
command only works when your working directory is a git repository that has a GitHub upstream configured. To open the tree view for the current branch, run
github
If GitHub 404s, make sure you have pushed the current branch.
To open the pull request for the current branch, run
github --pr
If the command fails, double check that your access token is valid and that a pull request has been opened for the current branch. Note that if multiple pull requests have been created for the current branch, the latest PR will be used.
Think you've found a bug? Please run in debug mode with the -d
flag and open an issue with the debug log.