KTop Docs

ktop is tracked from the Tknott95 crates.io catalog because it is above the 64-download threshold. Current tracked version is 0.1.7, with 134 downloads across 8 versions.

crates.io: https://crates.io/crates/ktop

Docs index: https://docs.rs/crate/ktop/latest

API docs: https://docs.rs/ktop/latest/ktop/

Cargo source: https://docs.rs/crate/ktop/latest/source/

Keep public site links pointed to crates.io/docs.rs while backend-published formal docs are prepared.

crates.io category: command-line-utilities.

crates.io keywords: htop, monitor, process, top, tui.

docs.rs package facts: 100% documented, 2 of 2 items documented, source code size 151.41 kB, documentation size 247.75 kB.

docs.rs dependencies: crossterm and libc.

ktop is a fast Linux top/htop-style process monitor written in Rust.

It includes a full Scrin-powered TUI, Aisling color/effect passes, spotlight grep overlay, mouse actions, anomaly detection, process tree mode, and non-TUI CLI paths for grep/kill workflows when the system or terminal is under stress.

Install:

cargo install ktop

Run from source:

cargo run --release

Fast path commands:

ktop --grep "cmd:python user:root"
ktop --kill "cmd:firefox" --signal TERM
ktop --kill 1234 --signal KILL --yes
ktop --anomalies --limit 20
ktop --diagnostics
ktop --stability-check --samples 120 --interval-ms 500.

--kill accepts a PID, comma-separated PIDs, or a spotlight query. Supported signals: TERM, KILL, STOP, CONT, INT, HUP.

Controls: q/Esc quit; / or Ctrl+F spotlight; j/k/arrows/Page/Home/End navigate; mouse hover/click/right-click/middle-click actions; T tree mode; A anomaly view; e lightweight Aisling effects; d detail pane; c/m/p/n/u/t/a sort; Tab cycle sort; r reverse; Space pause/resume; g refresh; s signal palette; K SIGTERM selected; x clear filter.

Spotlight tokens: user:, name:, cmd:, pid:, ppid:, uid:, state:, age>2h, age<10m, cpu>20, cpu<5, mem>1, mem<10, and !token exclusions. The same query style powers --grep and query-based --kill.

Header shows sort mode, view mode, load averages, process count, and thread count. Wide terminals show selected-process details: CPU/memory bars, identity, anomaly score, age, boot-relative start time, RSS/VIRT, thread count, tree depth, and wrapped command text.

Resilience: frame buffers are reused and capped, Scrin diffs changed cell runs, Aisling effects are sparse, tree traversal is iterative, history rings cap at 96 samples, spotlight input/query tokens are capped, CLI output is capped, /proc reads are bounded, user cache is bounded, and process metadata is retained only while PID/start-time remains live.

Platform:

ktop currently targets Linux and reads process data from /proc.