GitHub Issues on the command line. Use your $EDITOR, not your browser.
Clone or download


GitHub Issues on the command line. Use your $EDITOR, not your browser.

ghi was originally created by Stephen Celis, and is now maintained by Alex Chesters.


Via brew (latest stable release):

brew install ghi

Via gem (latest stable release):

gem install ghi

Via curl (latest bleeding-edge versions, may not be stable):

curl -sL > ghi && \
chmod 755 ghi && \
mv ghi /usr/local/bin


usage: ghi [--version] [-p|--paginate|--no-pager] [--help] <command> [<args>]
           [ -- [<user>/]<repo>]

The most commonly used ghi commands are:
   list        List your issues (or a repository's)
   show        Show an issue's details
   open        Open (or reopen) an issue
   close       Close an issue
   lock        Lock an issue's conversation, limiting it to collaborators
   unlock      Unlock an issue's conversation, opening it to all viewers
   edit        Modify an existing issue
   comment     Leave a comment on an issue
   label       Create, list, modify, or delete labels
   assign      Assign an issue to yourself (or someone else)
   milestone   Manage project milestones
   status      Determine whether or not issues are enabled for this repo
   enable      Enable issues for the current repo
   disable     Disable issues for the current repo

See 'ghi help <command>' for more information on a specific command.

Source Tree

You may get a strange error if you use SourceTree, similar to #275 and #189. You can follow the steps here to resolve this.


If you're looking for a place to start, there are issues we need help with!

Once you have an idea of what you want to do, there is a section in the wiki to provide more detailed information but the basic steps are as follows.

  1. Fork this repo
  2. Do your work:
  3. Make your changes
  4. Run rake build
  5. Make sure your changes work
  6. Open a pull request!


FAQs can be found in the wiki