computer-stats

One command to collect durable lifetime counters from your machine and walk through big-number screens in the terminal.

Run without publishing

npx /absolute/path/to/packages/computer-stats

From inside this repo:

node packages/computer-stats/bin/computer-stats.mjs

Intended published usage

npx computer-stats

That opens an interactive TUI. Press Space for next, ← for previous, and q to quit. The last screen is a short shareable summary, not another raw-stat dump.

Open the browser dashboard only if you ask for it:

npx computer-stats --browser

What it shows

• Lifetime data written and read
• One real-world anchor line under each big stat, scaled from sub-100 GB up through PB-class archives
• Power-on hours and power cycles
• Unsafe shutdowns
• Battery cycles, wear, and learned capacity
• Derived ratios like drive fills written and writes per powered day
• A compact scorecard table of the strongest numbers instead of a long prose summary
• Archive-scale comparisons using Wikimedia, Common Crawl, Netflix, Gmail, Apple battery guidance, and Library of Congress references
• Four-screen flow: Overview, Wear, Durability, then Scorecard

Current support

• macOS: best support, including battery pack telemetry and NVMe SMART via smartctl
• Linux: best-effort support for SMART and battery sysfs
• Windows: not implemented yet; the terminal output explains that directly

macOS requirement for storage lifetime counters

To get SSD lifetime counters on macOS, install smartctl:

brew install smartmontools

Without it, the terminal report still works, but storage lifetime counters will be missing.

CLI flags

computer-stats --json
computer-stats --plain
computer-stats --output stats.json
computer-stats --html report.html
computer-stats --browser
computer-stats --browser --port 4173

Publish

cd packages/computer-stats
npm publish --access public

If you want a different npm name or license, change package.json before publishing.