explaingit

petruisfan/node-supervisor

Analysis updated 2026-07-03

3,733JavaScriptAudience · developerComplexity · 1/5Setup · easy

TLDR

A small command-line tool for Node.js that watches your source files and automatically restarts your application when files change or the process crashes.

Mindmap

mindmap
  root((node-supervisor))
    What it does
      Watches files
      Restarts on change
      Restarts on crash
    Options
      Watch folders
      Ignore folders
      File extensions
      Polling interval
    Controls
      Manual restart rs
      Debug inspect flags
      Instant kill option
    Setup
      npm install global
      No config file
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run your Node.js server through supervisor so it restarts automatically every time you save a code file during development.

USE CASE 2

Keep a Node.js app running by having supervisor auto-restart it whenever it exits unexpectedly due to a crash or error.

USE CASE 3

Watch only specific folders and file extensions while ignoring others to control exactly which changes trigger a restart.

What is it built with?

JavaScriptNode.jsnpm

How does it compare?

petruisfan/node-supervisorforwardemail/email-templatesbloomberggraphics/whatiscode
Stars3,7333,7333,734
LanguageJavaScriptJavaScriptJavaScript
Setup difficultyeasymoderateeasy
Complexity1/52/51/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min
No license information is provided in the explanation.

In plain English

node-supervisor is a small command-line tool for Node.js that watches your code files and automatically restarts your program when they change. It serves a similar purpose to tools like nodemon: instead of manually stopping and starting your server every time you edit a file, you run your program through supervisor and it handles restarts for you. When a watched file changes, supervisor stops the running process and starts it again from scratch. Because it does a full restart, you avoid problems that can come from trying to reload modules in place, such as memory leaks or stale references between files. The tool is installed globally via npm and then used in place of node at the command line. You can tell it which folders or files to watch, which extensions to include, and which folders to ignore. By default it watches the current directory for changes to .js and .node files. Supervisor also handles crashes: if your program exits unexpectedly, supervisor restarts it automatically. You can control this behavior with flags to tell it not to restart on certain exit conditions, such as only when the program exits with an error code, or not at all. Other options include setting a polling interval, saving the supervisor process ID to a file, starting the process with Node debug or inspect flags, using instant kill instead of graceful shutdown, and logging which file triggered a restart. You can also type rs in the terminal while supervisor is running to trigger a manual restart without changing any files. Installation is a single npm install command. No configuration file is required.

Copy-paste prompts

Prompt 1
How do I install node-supervisor globally and use it instead of node to run my Express server so it auto-restarts on every .js file save?
Prompt 2
How do I configure node-supervisor to watch only my src/ folder, ignore node_modules, and restart on both .js and .json changes?
Prompt 3
My Node.js server crashes occasionally in production. How do I use node-supervisor to restart it automatically on crash and log which file triggered the restart?
Prompt 4
How do I use node-supervisor with the Node.js --inspect flag so I can attach a debugger while still getting auto-restarts on file changes?

Frequently asked questions

What is node-supervisor?

A small command-line tool for Node.js that watches your source files and automatically restarts your application when files change or the process crashes.

What language is node-supervisor written in?

Mainly JavaScript. The stack also includes JavaScript, Node.js, npm.

What license does node-supervisor use?

No license information is provided in the explanation.

How hard is node-supervisor to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is node-supervisor for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub petruisfan on gitmyhub

Verify against the repo before relying on details.