Gith

Installation

$ gem install gith
$ gith generate

Tokens

You can find your slack api token at https://api.slack.com/web

You can find your pivotal api token at https://www.pivotaltracker.com/profile

Usage

Gith is a drop in replacement for git and can be aliased. All regular git commands will work normally.

Pivotal recently added # symbol to it's story id copy button... Unfortunately bash sees # as a comment, so it screws up the arguments... For this reason, you can simply append the copied story id to the command itself. For example, both of these would validly estimate story id 213 at 2 points: "gith estimate 213 2" and "gith estimate#213 2".

Commands

estimate

Estimates a pivotal story.

# gith estimate [story_id] [points]
$ gith estimate 1234 1

start

Starts a Pivotal story and creates a new branch off master named according to the story.

# gith start [story_id]
$ gith start 1234

discuss

Essentially does the same as finish, but does not open up the pull request to review. Tags it with a "discussion" label so people know to look, but aren't required to review.

$ gith discuss

finish

Finishes a story, pushes to github, and opens a pull request. Will commit for you and rebase to master as well. Must be on the branch.

$ gith finish

deliver

Delivers the story. Marks as delivered and find staging branch and locks and deploys.

$ gith deliver

pass

Passes the pull request review. Marks as review-passed and comments on the pr.

# gith pass [pull_request_id]
$ gith pass 1

accept

Accepts the pivotal story.

$ gith accept [story_id]

reject

Rejects the pivotal story.

$ gith reject [story_id]

Contributing

  1. Fork it ( https://github.com/hired/gith/fork )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request

If you'd like to dogfood, let me know and I can add you to the tracker project. You'll also have to add a .env file to your directory setting GITH_ENV=dev