Man Linux: Main Page and Category List


       ghi - command-line interface to the GitHub Issues API


       ghi command [arguments] [options]


       This manual page documents briefly the ghi command.

       ghi  is  a  command-line  interface to the GitHub Issues API. It can be
       used to access all of GitHub’s documented Issues API (v2) functionality
       from the command line: open, close and manipulate issues.
       If  no  command  is  given,  the default action is list. If a number is
       given instead, the default action is show.


       list [ -s open|closed|all ]
              Show open, closed or all issues (choose  with  -s,  see  below).
              Default is open.

       show number
              Show  issue  number.  This  command  can  be invoked also as ghi

       open [ number ], o [ number ]
              Create a new issue, and launch  $EDITOR.  If  number  is  given,
              reopens that issue.

       close number, c number
              Closes issue number.

       edit number, e number
              Edit issue number with $EDITOR.

       label add|remove label number
              Add or remove label to/from issue number.
              You  can  use  al  or rl instead of, respectively, label add and
              label remove.

       search term, s term
              Search for term.

       comment number, m number
              Create a comment for issue number (with $EDITOR).


       -h, --help
              Show summary of options.

       -v, --verbose
              Show issue details (only for show, list  and  search  commands).
              Default is false.

       -V, --version
              Show program’s version number and exit.

       -s STATE, --state=STATE
              Specify   state   (only  for  list  and  search  (except  "all")
              commands). Choices are: open (o), closed (c), all  (a).  Default
              is open.

       -r REPO, --repo=REPO, --repository=REPO
              Specify  a  repository.  The  format: "user/repo" or just "repo"
              (latter will get the user from the global git config).

       -w, --web, --webbrowser
              Show issue(s) GitHub page in web browser (only for list and show
              commands). Default is false.


       github-cli was written by Sander Smits <>.

       This  manual  page was written by David Paleino <>, for
       the Debian project (and may be used by others).

                                April 13, 2010