Open source · zero-config clustering

Run, monitor & scale Node.js from one command.

MonitorX is a lightweight process manager with a built-in cluster mode. Share a port across N workers with zero code changes — plus live logs, auto-restart, and state that survives a daemon restart.

$ npm i -g @yamanzyan/monitorx

Watch it run Read the docs

Cluster mode built in Auto crash-recovery MIT licensed

Live session

Watch MonitorX run your commands

Start the daemon, spin up a fork, scale a cluster, list everything, and tail logs — all from a single CLI. This is a real session, looping.

zsh — monitorx

monitorx.config.js

module.exports = {
  processes: [
    {
      name: 'server',
      script: 'node process1/src/server.js',
    },
    {
      name: 'server2',
      script: 'node process2/src/server.js',
      instances: 2,   // → cluster of 2
    }
  ]
}

One file, every process

Declare it once.
monitorx start does the rest.

Drop a monitorx.config.js in your project root and every process boots with the right name, script, and worker count.

name

The identifier shown in monitorx ls, logs, and every command.

script

The shell command to run — e.g. node src/app.js.

instances

Any value > 1 enables cluster mode — N workers share one port, round-robin.

$ monitorx start

Lifecycle

A server, spinning up

Fork → boot → listen → online. MonitorX assigns the PID, tracks CPU and memory live, and restarts it automatically if it crashes.

CLI reference

Every command you need

Eight verbs, target anything by name or by ID. Run monitorx help <cmd> for details.

start-i -n

Start a script, a config file, or a stopped process. Add -i 4 for a cluster.

$ monitorx start server.js -n api -i 4

stop

Stop a running process or every worker in a cluster — by name or ID.

$ monitorx stop api

restart

Gracefully restart a process or a whole named cluster.

$ monitorx restart 2

delete

Stop and remove processes from the registry entirely.

$ monitorx delete api

ls

List every process with PID, mode, status, uptime, CPU and memory.

$ monitorx ls

logs

Stream live output from all processes or a single worker by ID.

$ monitorx logs 3

monitorx-daemon

The background daemon that manages your apps. Keep it running.

$ monitorx-daemon

help

Show all commands, or detailed help for a single command.

$ monitorx help start

State persists

Running processes are saved to ~/.monitorx/ and relaunch automatically when the daemon restarts.

Install in seconds

Ship Node.js processes that never go dark.

Free and open source. One global install gives you the CLI and the daemon.