syswatch 0.14.4

Single-host, read-only system diagnostics TUI. Twelve tabs covering CPU, memory, disks, processes, GPU, power, services, network, plus a Timeline scrubber and an Insights anomaly engine. Sibling to netwatch.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122

<p align="center">
  <h1 align="center">SysWatch</h1>
  <p align="center">
    <strong>System diagnostics in your terminal.</strong>
  </p>
  <p align="center">
    <a href="https://crates.io/crates/syswatch"><img src="https://img.shields.io/crates/v/syswatch.svg" alt="crates.io"></a>
    <a href="https://github.com/matthart1983/syswatch/releases"><img src="https://img.shields.io/github/v/release/matthart1983/syswatch" alt="Release"></a>
    <a href="https://repology.org/project/syswatch/versions"><img src="https://repology.org/badge/tiny-repos/syswatch.svg" alt="Packaging status"></a>
    <img src="https://img.shields.io/badge/platform-macOS%20%7C%20Linux-blue" alt="Platform">
    <img src="https://img.shields.io/badge/license-MIT-green" alt="License">
  </p>
</p>

<p align="center">
  <img src="demo-dense.gif" alt="SysWatch Dense: CPU, memory, network, per-core activity, disk throughput and processes on one screen" width="900">
</p>

<p align="center">
  <em>Live system activity in <code>syswatch --dense</code>.</em>
</p>

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

```bash
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](https://github.com/matthart1983/syswatch/releases/latest)
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](docs/REFERENCE.md#build-from-source).

## Run

```bash
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](docs/REFERENCE.md#keys) · [Full-view demo](demo.gif)

## The tabs

| Key | Tab | Shows |
|---|---|---|
| 1 | Overview | Activity across subsystems |
| 2 | CPU | CPU usage, load and per-core activity |
| 3 | Memory | Memory use, swap and pressure |
| 4 | Disks | Disk read/write activity |
| 5 | Filesystems | Capacity, inode use and mounts |
| 6 | Procs | Processes, resource use, sorting and filtering |
| 7 | GPU | Utilisation and memory, where available |
| 8 | Power | Battery and available power measurements |
| 9 | Services | systemd or launchd services |
| 0 | Net | Network traffic |
| - | Timeline | Session events and history scrubbing |
| + | Insights | Anomalies and suggested tabs to investigate |

## Views

| View | Size | For |
|---|---|---|
| Full | Tabbed | Exploring individual subsystems |
| Lite (`--lite`) | 80×24 | SSH sessions and small terminals |
| Dense (`--dense`) | Designed for 130×44 | CPU, memory, network, cores, disk and processes together |

In Dense, `1`–`6` zoom a panel and `Esc` restores the grid.
[View details](docs/REFERENCE.md#dense-view) · [Lite demo](demo-lite.gif)

## Record and report

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

```bash
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/REFERENCE.md#whats-distinctive).

## Docs

| | |
|---|---|
| [Reference](docs/REFERENCE.md) | Controls, views, recording and reports |
| [Platform support](docs/REFERENCE.md#scope) | Sensors, permissions, NVIDIA support and ZFS |
| [Architecture](docs/REFERENCE.md#architecture) | Collectors, history, rendering and refresh model |
| [Security](SECURITY.md) | Security policy |

## Related

[NetWatch](https://github.com/matthart1983/netwatch) covers network diagnostics;
[DiskWatch](https://github.com/matthart1983/diskwatch) covers disk activity.
They share the terminal layout and palette.

## Thanks

Community packagers maintain the Nix and Arch packages.
[Repology](https://repology.org/project/syswatch/versions) tracks package versions.
File packaging issues with the packagers and
[SysWatch bugs here](https://github.com/matthart1983/syswatch/issues).

## License

MIT