What is this I don't even

This is a scrum (or "scrum-but") tool for monitoring your sprint progress in Pivotal Tracker. By default it doesn't tell you anything that Pivotal Tracker can't: it uses your project's velocity to estimate how many points can still be completed in the current iteration. But if you give it a particular person's initials, it will try to do the same estimation for that particular person.

Of course this requires some extra assumptions. It won't do any good unless the stories in current already have owners. (This is "scrum-but": in our small team we each have our area of expertise and stories are assigned accordingly.) You will also need to give some more refined productivity estimates than the velocity calculated by Pivotal (how many feature points per day an individual team member expects to complete, and how much extra to budget for chores and bugs).


You'll need a unix-style environment (linux, terminal in a mac, or similar), with python and hg installed (and virtualenv if you follow my installation advice).

Installing (if you know enough to do this differently you don't need my advice):

$ hg clone
$ cd pivotal_slippage
$ virtualenv --no-site-packages .
$ bin/pip install zc.buildout
$ bin/buildout


Run the script from the commandline:

$ bin/slippage --help
$ bin/slippage --describe-format
$ bin/slippage --token <pivotal-api-token> --project <project-id>
$ bin/slippage --token <pivotal-api-token> --project <project-id> --users <initials>

The only absolutely necessary configuration is an API token for Pivotal Tracker and the ID of your project. You can give both on the commandline, or put them in a config file (see below) for convenience. The project ID can be found in the URL you use to access Pivotal Tracker; your API token is at the bottom of your "Profile" page in Pivotal Tracker.

Config file

Defaults for --token, --id, and --users can be specified in a config file, which must be located at ~/.slippage.rc

The same file can contain individual estimates (per-programmer) for how many feature points should be completed per day (default 3), how many points a bug or chore should count as for estimation purposes (default 1) and how many total points (features plus extras) should be completed per day (default 4).

The format of the config file is (where each line or block is optional):

token: <api-token>
project: <project-id>
users: <initials> <more-initials> <more-initials>

feature_per_day: <float>
total_per_day: <float>
bugs_chores: <float>


Here is some example output:

Screenshot of sample output

Run bin/slippage --describe-format to get a complete explanation of what it all means (including the pretty colours).