user@devops:~$ cat README.md
Vmstat Watch
# Description
Vmstat Watch is a C++23 CLI tool that reads and breaks down Linux kernel virtual memory statistics from /proc/vmstat — over 50 counters grouped in 7 categories: page faults (pgfault, pgmajfault, pgpgin, pgpgout), swap (pswpin, pswpout), NUMA (numa_hit, numa_miss, numa_foreign, numa_local, numa_other), workingset (refault, activate, restore, nodereclaim), slab (alloc, free, nr_pages), compaction (migrate_scanned, free_scanned, isolated, stall, fail, success, daemon_wake) and THP (thp_fault_alloc, thp_collapse_alloc, thp_split, thp_zero_page_alloc). Formats large values in B/M/K for quick reading (14.3B, 763.6M, 34.1K). Watch mode (--watch N) with periodic refresh that computes deltas between samples and rates per second. Includes full JSON output for scripting (--json) with 178+ counters sorted alphabetically, plain output for pipes (--no-color) and a 15-case self-test (--selftest). Zero dependencies: direct g++ -std=c++23 compilation, standard library only.
# Key features
$ Kernel virtual memory statistics: /proc/vmstat with 50+ counters in 7 categories
$ Human formatting: large values in B/M/K (14.3B, 763.6M, 34.1K) for quick reading
$ Automatic categorization: Page Faults, Swap, NUMA, Workingset, Slab, Compaction, THP
$ Watch mode with deltas and per-second rates between samples (--watch N)
$ Full JSON output with 178+ counters sorted alphabetically (--json)
$ 15-case self-test including live /proc/vmstat read (--selftest)
$ Zero dependencies: direct g++ build without CMake (C++23, GCC 14)
# Gallery
# Technologies used
