netwatch ~ ~/labs/kernwatch.md
preview·v0.4.1
cd~/labs/kernwatch
← all tools
kernwatch.tui

kernwatch

Linux kernel observability in your terminal.

Kernel diagnostics for Linux x86-64 and ARM64. Fourteen views connect tasks, scheduling, memory, I/O, cgroups and incident evidence.

Ordinary monitoring reads procfs/sysfs. Detailed latency and stack captures require explicit tracing and suitable kernel permissions.

$cargo install kernwatch --locked
~ $ kernwatchtui
// kernwatch · loops · no audio▶ play demo
// 01 · install

Install

Release binaries
Download releases →

Linux x86-64 and ARM64; glibc and static musl builds. Choose static musl for portability and verify the published checksum.

Cargo
$cargo install kernwatch --locked

Requires Linux x86-64 or ARM64, Rust 1.98+ and a C linker.

From source
$git clone https://github.com/matthart1983/kernwatch.git && cd kernwatch && cargo build --release --locked

Run ./target/release/kernwatch after building, or copy it to a directory on your PATH.

// 02 · build requirements
Build requirements

The executable embeds the checked-in BPF object. A BPF-capable Clang is needed only to rebuild probe sources. Source builds use the host C library; they are not automatically static.

// 03 · quick start

Quick start

Use 160 columns for the full dashboard; compact layouts work at 80×24. Source builds can be launched as ./target/release/kernwatch.

  1. 1
    Monitor the current host
    $kernwatch --view dense
  2. 2
    Explore without host probes or changes
    $kernwatch --demo-tour
  3. 3
    Replay a recorded session
    $kernwatch --replay capture.kwr
// 04 · tracing permissions
Tracing permissions

Opening a tab does not start tracing. On Syscalls (6), l starts a bounded capture and x stops it. Kernel BPF permissions are required; failures remain visible. kernwatch does not elevate itself.

// 05 · navigation

Navigation

KeyView
0Dense
1–9Overview, Tasks, Scheduler, Memory, Block, Syscalls, IRQ, Cgroups, Modules
beBPF
mDmesg
dDiagnose
FFlame profiles
rToggle recording
eExport evidence
qQuit
// related