matthart1983/syswatch

Single-host system diagnostics TUI.

Rust

914

101 commits

updated Oct 17, 2026

See the code

README

SysWatch

System diagnostics in your terminal.

crates.io Release Packaging status Platform License

SysWatch Dense: CPU, memory, network, per-core activity, disk throughput and processes on one screen

Live system activity in syswatch --dense.

Monitor CPU, memory, disks, processes, GPU, power and network activity on macOS and Linux. Scrub recent history, record sessions, and investigate spikes with heuristic anomaly cards. SysWatch is read-only and runs without sudo; available measurements depend on your platform and permissions.

Install

brew install syswatch                 # macOS / Linux
nix-shell -p syswatch                 # NixOS / Nix
paru -S syswatch                      # Arch (AUR)
cargo install syswatch                # build from source with Rust

Prebuilt binaries are available for macOS and Linux (x86_64 and aarch64), with static Linux builds and an armv5te build for older NAS hardware. Build from source.

Run

syswatch                       # twelve tabs, default 1 Hz refresh
syswatch --lite                # one 80×24 screen
syswatch --dense               # all main subsystems, designed for 130×44
syswatch --tab procs           # start on Processes

1–9, 0, - and + switch tabs. V cycles views, ? shows help, q quits. Use ← / → to scrub recent history and End to return live.

Every keybinding · Full-view demo

The tabs

KeyTabShows
1OverviewActivity across subsystems
2CPUCPU usage, load and per-core activity
3MemoryMemory use, swap and pressure
4DisksDisk read/write activity
5FilesystemsCapacity, inode use and mounts
6ProcsProcesses, resource use, sorting and filtering
7GPUUtilisation and memory, where available
8PowerBattery and available power measurements
9Servicessystemd or launchd services
0NetNetwork traffic
-TimelineSession events and history scrubbing
+InsightsAnomalies and suggested tabs to investigate

Views

ViewSizeFor
FullTabbedExploring individual subsystems
Lite (--lite)80×24SSH sessions and small terminals
Dense (--dense)Designed for 130×44CPU, memory, network, cores, disk and processes together

In Dense, 1–6 zoom a panel and Esc restores the grid. View details · Lite demo

Record and report

Press R to record an interactive session or S to save a snapshot.

syswatch --record --keep 24h          # foreground recording without a TUI
syswatch --replay session.swr         # replay a recording
syswatch snapshot --json             # one live sample
syswatch why                         # sample for 30s, explain detected anomalies
syswatch diff before.swr after.swr   # compare recordings

Live scrubbing holds 120 samples (two minutes at the default refresh rate). Record longer sessions to disk. Headless recording rotates files and prunes old chunks according to --keep; it runs until stopped. Recording and report details.

Docs

ReferenceControls, views, recording and reports
Platform supportSensors, permissions, NVIDIA support and ZFS
ArchitectureCollectors, history, rendering and refresh model
SecuritySecurity policy

NetWatch covers network diagnostics; DiskWatch covers disk activity. They share the terminal layout and palette.

Thanks

Community packagers maintain the Nix and Arch packages. Repology tracks package versions. File packaging issues with the packagers and SysWatch bugs here.

License

MIT

matthart1983/syswatch

Single-host system diagnostics TUI.

Rust

914

101 commits

updated Oct 17, 2026

See the code

README

SysWatch

System diagnostics in your terminal.

crates.io Release Packaging status Platform License

SysWatch Dense: CPU, memory, network, per-core activity, disk throughput and processes on one screen

Live system activity in syswatch --dense.

Monitor CPU, memory, disks, processes, GPU, power and network activity on macOS and Linux. Scrub recent history, record sessions, and investigate spikes with heuristic anomaly cards. SysWatch is read-only and runs without sudo; available measurements depend on your platform and permissions.

Install

brew install syswatch                 # macOS / Linux
nix-shell -p syswatch                 # NixOS / Nix
paru -S syswatch                      # Arch (AUR)
cargo install syswatch                # build from source with Rust

Prebuilt binaries are available for macOS and Linux (x86_64 and aarch64), with static Linux builds and an armv5te build for older NAS hardware. Build from source.

Run

syswatch                       # twelve tabs, default 1 Hz refresh
syswatch --lite                # one 80×24 screen
syswatch --dense               # all main subsystems, designed for 130×44
syswatch --tab procs           # start on Processes

1–9, 0, - and + switch tabs. V cycles views, ? shows help, q quits. Use ← / → to scrub recent history and End to return live.

Every keybinding · Full-view demo

The tabs

KeyTabShows
1OverviewActivity across subsystems
2CPUCPU usage, load and per-core activity
3MemoryMemory use, swap and pressure
4DisksDisk read/write activity
5FilesystemsCapacity, inode use and mounts
6ProcsProcesses, resource use, sorting and filtering
7GPUUtilisation and memory, where available
8PowerBattery and available power measurements
9Servicessystemd or launchd services
0NetNetwork traffic
-TimelineSession events and history scrubbing
+InsightsAnomalies and suggested tabs to investigate

Views

ViewSizeFor
FullTabbedExploring individual subsystems
Lite (--lite)80×24SSH sessions and small terminals
Dense (--dense)Designed for 130×44CPU, memory, network, cores, disk and processes together

In Dense, 1–6 zoom a panel and Esc restores the grid. View details · Lite demo

Record and report

Press R to record an interactive session or S to save a snapshot.

syswatch --record --keep 24h          # foreground recording without a TUI
syswatch --replay session.swr         # replay a recording
syswatch snapshot --json             # one live sample
syswatch why                         # sample for 30s, explain detected anomalies
syswatch diff before.swr after.swr   # compare recordings

Live scrubbing holds 120 samples (two minutes at the default refresh rate). Record longer sessions to disk. Headless recording rotates files and prunes old chunks according to --keep; it runs until stopped. Recording and report details.

Docs

ReferenceControls, views, recording and reports
Platform supportSensors, permissions, NVIDIA support and ZFS
ArchitectureCollectors, history, rendering and refresh model
SecuritySecurity policy

NetWatch covers network diagnostics; DiskWatch covers disk activity. They share the terminal layout and palette.

Thanks

Community packagers maintain the Nix and Arch packages. Repology tracks package versions. File packaging issues with the packagers and SysWatch bugs here.

License

MIT

Project health

crates.io

Latest release

0.14.4 · Oct 17, 2026

Releases this year

33

Significant stargazers

Orhun Parmaksız

5,496 followers · starred Jun 2026

cgzones

66 followers · starred Jul 2026

Hiroaki Nakamura

296 followers · starred May 2026

Darren Schroeder

203 followers · starred Jun 2026