Tool that allows you to work with Pivotal Tracker from the command line
Pull request Compare This branch is 6 commits ahead of hone:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Git Pivot

Tool that allows you to work with Pivotal Tracker from the command line.

Installation and Usage

To install:

$ gem install hone-git_pivot -s

Now you'll need to add a git_pivot.yml to the root directory of your project:

project_id: 213992
token: 3a9390ed9309ba304903939ae948298
owner: Matt Buck
use_git: true

… where owner is your name as it appears in the Pivotal Tracker interface. Set use_git to true if you want GitPivot to automatically create (local) topic branches when you start a story.

Current Features

  • display stories in current

  • display stories under “My Work”

  • start a story (optional git support to start a topic branch)

  • display a story with associated “Notes”

  • add a note to a story

  • finish a story

  • list tasks for a story

  • add a task to a story

  • complete tasks

Planned Features

Planned features include:

  • search for stories

  • backlog stories

Note on Patches/Pull Requests

  • Fork the project.

  • Make your feature addition or bug fix.

  • Add tests for it. This is important so I don't break it in a future version unintentionally.

  • Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but

    bump version in a commit by itself I can ignore when I pull)
  • Send me a pull request. Bonus points for topic branches.


  • need key/value store to keep track of stories with branches

  • should we keep track of what story we're working on?


Copyright © 2009 Terence Lee. See LICENSE for details.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.