Gem for slurping plain text stories into Pivotal Tracker
Pull request Compare This branch is 10 commits ahead, 81 commits behind hashrocket:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.



Slurper allows you to quickly compose your stories in a text file and import them into Pivotal Tracker.

Works great with slurper.vim! (

Update Capbability

After slurping, surp will make a backup of your original slurp file and replace it with a new file containing an id element for each story added. As long as this id element remains present you can modify the story with changes being synced next time you run slurp on the file.

If you add new stories to the file, these will be created on next slurp and given an id also. Hence you can update and add to the same file.

Note that by default a backup file will be created of your original slurp. The '-n' option can be used if you trust slurp to write over the original file.

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.


$gem install slurper


Create a story_defaults.yml file in your working directory for project stories.


project_id: 1234
token: 123abc123abc123abc
requested_by: Jane Stakeholder

The project_id tells tracker which project to add your stories to. It can be found on the project settings or the url for the project.

The token can be found on your personal profile page in Pivotal Tracker.

The name, labels and description fields provide slurper with default values for story titles and descriptoins if you don't provide them in your stories.slurper file.

The requested_by field should be the name of your project stakeholder exactly as it appears in tracker.


Create a stories.slurper file and compose your stories in the slurper story format. In your working directory use the slurp command to import your stories from the stories.slurper file into Pivotal Tracker. If you have multiple story files for a project, stories.slurper and stories2.slurperfor example you can explicitly provide which file to slurp.

$slurp stories2.slurper


  User Create Something
  In order to accomplish some business value
  As a User
  I want to create something


Note: stories must have == before and after each story.

Credit - Wes Gibbs ( thought of and wrote slurper as a ruby script. It was later packaged and released as a gem by his fellow Rocketeers after using it and finding it extremely handy.