mini-pm2

Minimal process manager with daemon, workspaces, hooks, health checks and a zero‑dependency TUI monitor.

Install

pnpm add mini-pm2
# or
npm i mini-pm2

CLI

mini-pm2 daemonize
mini-pm2 status
mini-pm2 stop-daemon
mini-pm2 monitor

Start apps

mini-pm2 start app.json
mini-pm2 start workspace.json
mini-pm2 start <appName>
mini-pm2 start <workspaceName>

Example app.json

{
  "name": "api",
  "script": "node server.js",
  "cwd": "C:/projects/api",
  "instances": 1,
  "hooks": {
    "onStart": "echo START",
    "onExit": "echo EXIT",
    "onRestart": "echo RESTART",
    "onStop": "echo STOP"
  },
  "health": {
    "command": "node healthcheck.js",
    "intervalSec": 30,
    "retries": 3,
    "timeoutSec": 5,
    "maxFailsBeforeStop": 6
  }
}

Example workspace.json

{
  "name": "my-workspace",
  "apps": [
    { "name": "api", "script": "node server.js" },
    { "name": "web", "script": "pnpm dev", "cwd": "C:/projects/web" }
  ]
}

Security token

Set MINI_PM2_TOKEN for both daemon and clients:

# Windows PowerShell
$env:MINI_PM2_TOKEN = "my-token"

# Linux/macOS
export MINI_PM2_TOKEN="my-token"

Library usage

import { startDaemon } from "mini-pm2"

startDaemon()

Notes

• State and logs are stored in ~/.mini-pm2.
• The monitor uses an alternate screen and partial redraw to avoid flicker.

License

MIT