netpulse ⚡

A production-grade network diagnostics CLI tool. Check connectivity, latency, Wi-Fi signal strength, download/upload speed, and port reachability — all from your terminal.

Installation

# Install dependencies
npm install

# Install globally (use as `netpulse` anywhere)
npm install -g .

Commands

| Command | Description | |---|---| | netpulse check | Run full diagnostics (connectivity + Wi-Fi) | | netpulse ping [host] | Ping a host, measure latency & packet loss | | netpulse speed | Run a download/upload speed test | | netpulse wifi | Show Wi-Fi signal strength and connection info | | netpulse port <host> <port> | Check if a host:port is open |

All commands support --json for machine-readable output.

Examples

# Full diagnostics
netpulse check

# Ping with 10 samples
netpulse ping google.com -c 10

# Speed test
netpulse speed

# Wi-Fi info
netpulse wifi

# Check if a port is open
netpulse port api.myservice.com 443

# JSON output (for scripting/CI)
netpulse ping 8.8.8.8 --json
netpulse check --json | jq '.overall'

Exit Codes

| Code | Meaning | |---|---| | 0 | All checks passed | | 1 | Degraded / warnings | | 2 | Critical failure |

These make netpulse scriptable in CI pipelines, shell scripts, and monitoring tools.

Requirements

• Node.js 14+
• macOS / Linux (Wi-Fi checks may require sudo on some systems)
• Windows support: connectivity and port checks work; Wi-Fi may be limited