Skip to content
This repository

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

Fetching latest commit…


Cannot retrieve the latest commit at this time

Octocat-spinner-32 bin
Octocat-spinner-32 lib
Octocat-spinner-32 .document
Octocat-spinner-32 .gitignore
Octocat-spinner-32 LICENSE
Octocat-spinner-32 README.rdoc
Octocat-spinner-32 Rakefile
Octocat-spinner-32 VERSION
Octocat-spinner-32 git_pivot.gemspec
Octocat-spinner-32 git_pivot.yml.example

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.

Something went wrong with that request. Please try again.