Real-Time
System Monitor
for Node.js

const { CrystalSystem } = require('@crystal-studio-labs/crystalsystem.js');

const cs = new CrystalSystem({
  interval:   2000,
  thresholds: { cpu: 80, memory: 75, disk: 85 },
});

// Fires every tick with a full SystemStats object
cs.on('data', (stats) => {
  console.log('CPU:',  stats.cpu.loadPercent);
  console.log('RAM:',  stats.memory.percent);
  console.log('Net↓:', stats.network.rxSpeed);
  console.log('Net↑:', stats.network.txSpeed);
});

// Fires when a threshold is breached
cs.on('alert', ({ type, message, value, threshold }) => {
  console.error(`⚠️  [${type.toUpperCase()}] ${message}`);
  // Send to Discord, Slack, Telegram, email — see Alerts section
});

cs.on('stop', () => console.log('Monitor stopped.'));

cs.start();

// Change a threshold at runtime (no restart needed)
cs.setThreshold('cpu', 70);

// One-shot snapshot without a display loop
const snap = cs.snapshot();
console.log(snap.cpu.model, snap.memory.total);

// Stop after 60 seconds
setTimeout(() => cs.stop(), 60_000);

const { crystalsystem, startHttpServer } = require('@crystal-studio-labs/crystalsystem.js');

// Start dashboard + HTTP API together
crystalsystem({ httpPort: 3001 });

// ── Available endpoints ──────────────────────────────
// GET /          → All stats as JSON
// GET /cpu       → CPU model, speed, cores, usage %
// GET /memory    → Total, used, free, percent
// GET /network   → Speeds + cumulative traffic
// GET /disk      → Partitions, total, used, free
// GET /battery   → Level, charging status
// GET /health    → { status: 'ok', uptime: ... }
// All responses include Access-Control-Allow-Origin: *

// Or start the API server independently (no dashboard)
const server = startHttpServer(4000);
// server is a Node.js http.Server — call server.close() to stop

// Fetch from anywhere
const res  = await fetch('http://localhost:3001/cpu');
const data = await res.json();
console.log(data.model, data.loadPercent);

const { crystalsystem, createLogger, getAllStats } = require('@crystal-studio-labs/crystalsystem.js');

// Auto-log every tick via the main monitor
crystalsystem({ logFile: 'stats.json', interval: 10_000 });

// ── Or log manually ──────────────────────────────────
const logger = createLogger('stats.json');

// Write a snapshot right now
logger.write(getAllStats());

// Read all saved snapshots back
const history = logger.readAll();
console.log(`${history.length} entries recorded`);

// Analyse: find peak and average CPU
const peakCPU = Math.max(...history.map(s => s.cpu.loadRaw));
const avgCPU  = history.reduce((a, s) => a + s.cpu.loadRaw, 0) / history.length;
console.log(`Peak: ${peakCPU.toFixed(2)}%  Avg: ${avgCPU.toFixed(2)}%`);

import crystalsystem, {
  CrystalSystem,
  CrystalSystemOptions,
  SystemStats,
  AlertEvent,
  CPUInfo,
  MemoryInfo,
} from '@crystal-studio-labs/crystalsystem.js';

const options: CrystalSystemOptions = {
  interval:   3000,
  thresholds: { cpu: 80, memory: 75, disk: 85 },
  httpPort:   3001,
};

const cs: CrystalSystem = crystalsystem(options);

cs.on('data', (stats: SystemStats) => {
  const cpu: CPUInfo    = stats.cpu;
  const mem: MemoryInfo = stats.memory;
  console.log(cpu.loadPercent, mem.percent);
});

cs.on('alert', (alert: AlertEvent) => {
  console.error(`[${alert.type.toUpperCase()}] ${alert.message}`);
});

# Install globally
$ npm install -g @crystal-studio-labs/crystalsystem.js

# Live dashboard (5s refresh default)
$ crystalsystem

# Custom interval
$ crystalsystem -i 2

# One-shot display then exit
$ crystalsystem --once

# JSON snapshot to stdout (pipe-friendly)
$ crystalsystem --json | jq '.cpu.loadPercent'

# Dashboard + HTTP API on port 3001 + file log
$ crystalsystem -p 3001 -l stats.json

# Hide sections you don't need
$ crystalsystem --no-disk --no-gpu --no-battery

# Pipe clean output to a file
$ crystalsystem --once --no-color > snapshot.txt

# All flags
$ crystalsystem --help