stephencelis / ghi
watch download tarball
public
Forks3Right
Watchers58Right
Description: GitHub Issues on the command line. Use your $EDITOR, not your browser.
Homepage:
Clone URL: git://github.com/stephencelis/ghi.git
ghi /
name age
history
message
file .autotest Mon Apr 27 07:45:26 -0700 2009 Basic .autotest file. [stephencelis]
file .gitignore Tue Apr 21 21:43:32 -0700 2009 The basics. [stephencelis]
file History.rdoc Mon Nov 30 10:29:52 -0800 2009 Bump gemspec. [stephencelis]
file MIT-LICENSE Tue Apr 21 21:43:32 -0700 2009 The basics. [stephencelis]
file Manifest.txt Tue Apr 21 21:43:32 -0700 2009 The basics. [stephencelis]
file README.rdoc Sun Nov 29 07:44:51 -0800 2009 Remove defunct Gemcutter sourcing instructions. [stephencelis]
file Rakefile Sun Apr 26 17:34:10 -0700 2009 Add a rakefile. Run specs through Rake. [jamie]
directory bin/ Wed Aug 05 16:23:17 -0700 2009 Cleanup. [stephencelis]
file ghi.gemspec Mon Nov 30 10:29:52 -0800 2009 Bump gemspec. [stephencelis]
directory lib/ Mon Nov 30 10:27:39 -0800 2009 Net::HTTP post params must be stringified keys ... [stephencelis]
directory spec/ Mon Nov 30 10:27:39 -0800 2009 Net::HTTP post params must be stringified keys ... [stephencelis]
README.rdoc

ghi

github.com/stephencelis/ghi

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

HOW?

Get: 

  % gem install ghi

Go: 

  Usage: ghi [options]
      -l, --list [state|term|number]
          --search, --show
      -v, --verbose
      -o, --open [title|number]
          --reopen
      -c, --closed, --close [number]
      -e, --edit [number]
      -r, --repo, --repository [name]
      -m, --comment [number|comment]
      -t, --label [number] [label]
          --claim [number]
      -d, --unlabel [number] [label]
      -u, --url [state|number]
          --[no-]color
          --[no-]pager
      -V, --version
      -h, --help

EXAMPLE?

ghi works simply from within a repository. Some short examples: 

  ghi -l                    # Lists all open issues
  ghi                       # Shorter shorthand for "ghi -l"
  ghi -v                    # Lists all open issues, verbosely (includes body)
  ghi -lc                   # Lists all closed issues
  ghi -l "doesn't work"     # Searches for open issues matching "doesn't work"
  ghi -l invalid -c         # Searches for closed issues matching "invalid"
  ghi -l1                   # Shows issue 1
  ghi -1                    # Shorter shorthand for "ghi -l1"
  ghi 1                     # Shorter shorthand still
  ghi -o                    # Opens a new issue (in your $EDITOR)
  ghi -o "New issue"        # Opens a new issue with the title "New issue"
  ghi -o "Title" -m "Body"  # Opens a new issue with specified title and body
  ghi -e1                   # Edits issue number 1 (in your $EDITOR)
  ghi -e1 -m "New body"     # Edits issue number 1 with the specified body
  ghi -c1                   # Closes issue 1
  ghi -c1 -m                # Closes issue with comment (from your $EDITOR)
  ghi -c1 -m "Comment"      # Closes issue with specified comment
  ghi -o1                   # Reopens 1 (accepts comments, too)
  ghi -m1                   # Comments on issue 1 (in your $EDITOR)
  ghi -t1 "tag"             # Labels issue 1 with "tag"
  ghi -d1 "tag"             # Removes the label, "tag"
  ghi --claim 1             # Tags issue 1 with your GitHub username
  ghi -u                    # Loads issues in your browser.
  ghi -u1                   # Loads an issue in your browser.

ghi also works anywhere: 

  ghi -rghi                 # Your fork of "ghi"
  ghi -rstephencelis/ghi    # Mine: "stephencelis/ghi"
  ghi stephencelis/ghi      # Shorthand to merely list open.

ghi uses ANSI colors if you use them in git.

ghi looks for a $GHI_PAGER variable for paging.

CONTRIBUTORS

CONTRIBUTE?

ghi is not under currently under the control of any gem packaging system. To build, use RubyGems: 

  % gem build ghi.gemspec
  % sudo gem install ghi*.gem