Skip to content
Pre-populate commit messages with your Pivotal Tracker story ID
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
assets
project
runner
scripts
util
vendor
.gitignore
.travis.yml
LICENSE
README.md
cli.go
glide.lock
glide.yaml

README.md

Inflight

GitHub version Build Status Coverage Status

Inflight finds the ID of your currently started Pivotal Tracker story and adds it to your commit message. The story is located using the Git author's email.

Given you've started a story:

Tracker commit example

When you're ready to commit:

git commit

The story ID is ready and waiting in your commit message:


# Please enter the commit message for your changes. Lines starting
# with '#' will be ignored, and an empty message aborts the commit.
# On branch master
# Changes to be committed:
#       new file:   <% some changes %>
#

[#89688392]

Background

Pivotal Tracker & Github allow you to easily link commits to your tracker stories. When you craft a commit message like this:

My words of wisdom

[#<story-id>]

You'll see this commit linked in the activity of your story:

Tracker commit example

Installation

  1. Download the latest release and place the binary on your path, e.g. /usr/local/bin/inflight

    Alternatively if you have Go installed, run:

    go get github.com/odlp/inflight
  2. cd to the repo you'd like to configure.

  3. Create a Git prepare commit message hook:

    touch .git/hooks/prepare-commit-msg
  4. Edit the hook:

    #!/bin/bash
    
    export TRACKER_API_TOKEN="<your-tracker-api-token>"
    export TRACKER_PROJECT_ID="<your-tracker-project-id>"
    inflight -o "$1"

    Your Pivotal Tracker API key is located in Your Profile. The project ID is visible in the address bar of your browser whilst viewing the project.

  5. Make the hook executable:

    chmod +x .git/hooks/prepare-commit-msg

Limitations

  • The git author's email must match the email used for Pivotal Tracker.
  • If you have more than one story started then the most recently updated story ID will be picked.

Todo

  • Add interactive git hook setup
You can’t perform that action at this time.