node package manager



Build Status Dependencies Status Coverage Status Published Version
npm Badge

Nestor Ninja Blocks

Nestor Ninja Blocks is CLI for Jenkins Ninja Blocks notifier.

This is handy for monitoring Jenkins build status on a Ninja Blocks device.


npm install -g nestor-ninjablocks


Monitor build status and notify Ninja Blocks device:

nestor-ninjablocks run

Monitor build status of a job:

nestor-ninjablocks run --job <job>

Monitor build status of a view:

nestor-ninjablocks run --view <view>

To customise status-hexcolour map:

nestor-ninjablocks run --scheme red,blue,yellow --map FAIL=FF0000,OK=00FF00,WARN=FFFF00

If your team keeps ignoring failure notifications, you can blink the build light on failure (WARNING: this will annoy your team, and someone will either go berserk or fix the build a.s.a.p):

nestor-ninjablocks run --blink-on-failure


Set Ninja Blocks API token in NINJABLOCKS_TOKEN environment variable:


export NINJABLOCKS_TOKEN=<token_from_>


set NINJABLOCKS_TOKEN=<token_from_>

Set Jenkins URL in JENKINS_URL environment variable (defaults to http://localhost:8080):


export JENKINS_URL=http://user:pass@host:port/path


set JENKINS_URL=http://user:pass@host:port/path

As an alternative to password, you can use Jenkins API token instead. Jenkins API token can be found on Jenkins user configuration page.


Developer's Guide

Build reports:


Related Projects: