bitbucket-build-status-hook

Bitbucket Build Status Hook

This Git post-checkout hook displays the latest build status for a commit when you check it out in your terminal. This allows you to quickly tell if your feature branch is failing, or whether it's safe to create a new branch from master!

Usage

This tool is most useful when symlinked as a post-commit hook, which runs every time you check out a branch or commit:

That said, you can manually run bitbucket-build-status to check the build status of your repository's HEAD commit at any time.

Installation

1. Install Node.js
2. Run npm install -g bitbucket-build-status-hook
3. Navigate to the root of a Git repository that you've cloned from Bitbucket
4. Run ln -s /usr/local/bin/bitbucket-build-status .git/hooks/post-checkout
5. Run git checkout HEAD to test that the hook is properly installed

Note: Windows users may need to copy instead of ln

Credential management

The first time you upload a file you will be prompted for your Bitbucket email and password. These will be used to retrieve an OAuth refresh token which is stored in ~/.bitbucket-build-status and used for subsequent requests. Treat this token carefully as it can be used to read repository data on your behalf.