wirespeed

Fast, zero-dependency internet speed test for the terminal. Measures download, upload, and latency using Cloudflare's global edge network.

$ npx wirespeed

  wirespeed v1.0.0

  Server    Cloudflare — Mumbai (BOM)
  IP        203.0.113.42

  Latency   12.34 ms (jitter: 1.23 ms)
  Download  245.67 Mbps
  Upload    98.12 Mbps

Install

npm install -g @mayurpise/wirespeed

Or run directly:

npx @mayurpise/wirespeed

Usage

wirespeed                 # Run full speed test
wirespeed --json          # Output results as JSON
wirespeed --no-upload     # Skip upload test
wirespeed --no-download   # Skip download test

Options

| Flag | Description | | ---------------- | -------------------- | | --json | Output results as JSON | | --no-download | Skip download test | | --no-upload | Skip upload test | | -h, --help | Show help | | -v, --version| Show version |

JSON output

wirespeed --json | jq .

{
  "server": { "colo": "BOM", "city": "Mumbai", "ip": "203.0.113.42" },
  "latency": { "median": 12.34, "jitter": 1.23, "unit": "ms" },
  "download": { "speed": 245.67, "unit": "Mbps" },
  "upload": { "speed": 98.12, "unit": "Mbps" }
}

How it works

wirespeed uses Cloudflare's speed test infrastructure (speed.cloudflare.com):

1. Server detection — Identifies the nearest Cloudflare edge via /cdn-cgi/trace
2. Latency — 20 zero-byte round trips, reports median and jitter
3. Download — Multi-phase parallel requests with increasing payload sizes (100KB to 100MB)
4. Upload — Multi-phase parallel uploads (100KB to 10MB)

Bandwidth is calculated at the 90th percentile across all measurements for accuracy. Real-time speed is smoothed with an exponential moving average.

Requirements

• Node.js >= 18.0.0

License

MIT