Tracker CLI

A mostly-for-fun Command Line Interface (CLI) for Pivotal Tracker

Installation

Configure

An API Token and Project ID are required in the configuration file.

1) Find your API Token

Your API Token is located at https://www.pivotaltracker.com/profile.

2) Find your Project ID

Your Project ID is located in the project's url. If your project url is https://www.pivotaltracker.com/n/projects/999999, this project's id is 999999.

3) Create a config file

Open ~/.tracker.config in your favorite text editor and enter the following yaml:

api_token: {{API_TOKEN}}
project: {{PROJECT_ID}}

Add to your Gemfile

gem 'tracker-cli', github: 'benastan/tracker-cli'

Take it for a test drive

tracker --list stories
=> 00001  "My First Story"

Usage

List

tracker --list stories

00001 "Story 1"
00002 "Story 2"

tracker --list stories --format json # JSON format
tracker --list projects
tracker --list projects --format json # JSON format

Fetch

tracker --fetch [OBJECT_TYPE]

OBJECT_TYPE can be story.

Story

A story can be fetched interactively:

tracker --fetch story -i

(1) 00001 "Story #1"
(2) 00002 "Story #2"
(3) 00002 "Story #3"

Which Story? 1

Or with an id:

tracker --fetch story --id 00001

Make a commit for a started story of your choice.

tracker --fetch story -i --parameter with_state,started --commit
(1) 133544285 "Test Story"

Which Story? 1

[master 2886e30] [#133544285] Test Story
 7 files changed, 94 insertions(+), 23 deletions(-)