node-git-pivotal
An integration for Git and Pivotal Tracker, written in node. Install it with
npm install -g pivotal-git
git start
git list
This lists out all the stories you have pending that you have started via git start.
git finish
git deliver
git roll [-r command] <branch> [msg]
Rolls (read merge via a squash) provided branch name into current branch commiting it with provided message.
- <branch>: the branch to be rolled into your current branch.
- [msg]: the message to be used for the merge commit. Optionaly can be entered via a later prompt.
- [-r command]: run custom command in before merging. If this command exits with a code other than 0 the roll will stop.
git story find <search>
lets you search pt for stories.
All args after find are joined together with a space. This means git story find "my best friend" is the same as git story find my best friend.
Search Commands
- Any of the PT search commands
- mine: will only list your stories
- curr: will only list stories that have been scheduled and have not be accepted.
- work: combines mine and curr.
Example
git story find _mine_will list all of my stories.git story find on-sitewill list all stoires that match "on-site".
git cleanup [[-D|-d] -K -r <remote>] <branches...>
Removes both the local and remote copies of specified branch(es).
- -D: Delete a branch irrespective of its merged status.
- -d: (default) The branch must be fully merged in its upstream branch, or in HEAD if no upstream was set
- -K: force remote KILL even if local branch is not found or can't be deleted.
- -r <remote>: (default:origin) lets you set a custom remote.
Examples
git cleanup myTopicBranchwill delete the local branch myTopicBranch and the remote branch origin/myTopicBranchgit cleanup -D -K -r fork idea other-ideawhere idea is a local unmerged branch and other-idea is only remote this command will delete idea, fork/idea, fork/other-idea.