node package manager
Love JavaScript? Your insights can make it even better. Take the 2017 JavaScript Ecosystem Survey »



npm version Dependency Status

A wrapper around nodemon and node-inspector - basically let's you use node-inspector in watch-mode.


Install it from npm:

npm install icebug --save-dev

Please note that I've used ES6 syntax, so node v4 or above is required.


Although I never recommend installing modules globally, if you installed icebug with the -g flag, you should be able to run icebug path/to/file.js.

However, I recommend you install the package locally, and add an npm run script to your package.json.

  "scripts": {
    "debug": "icebug path/to/file.js"

Because npm is smart, it'll look in the local node_modules folder.


icebug uses rc, which in turn uses minimist, which means configuration can come from CLI arguments as well as a .icebugrc file.

The configuration allows you to change the ports used, as well as passing additional arguments to nodemon and node-inspector.

Sample .icebugrc file with defaults:

  // node-inspector web port
  "webport": 8080,
  // debugging port
  "debugport": 5858,
  // node-inspector's --save-live-edit
  "edit": true,
  // use debug-brk
  "break": false,
  // Additional args to pass to nodemon
  "nodemonargs": "",
  // Additional args to pass to node-inspector
  "inspectorargs": ""

These can be overriden with the CLI, e.g.

icebug --break --webport=7070


Jeff Hansen - @Jeffijoe

Inspiration from nodev - the reason I made this module was because portscanner which nodev uses does not install easily on Windows.