A zero-dependency TUI resource monitor written in LuaJIT
Zero-dependency TUI resource monitor written in LuaJIT, compiled into a single self-contained ELF binary.
Heavy day-to-day use of the GPU — for graphics work and running local LLMs — on top of the usual CPU load, meant I neede
A zero-dependency TUI resource monitor written in LuaJIT
Heavy day-to-day use of the GPU — for graphics work and running local LLMs — on top of the usual CPU load, meant I needed a terminal-based resource monitor that could show how usage trends over time, not just an instantaneous snapshot. The scrolling history graphs are directly inspired by oscilloscope displays.
Clone the repo and run make (needs libluajit-5.1-dev), then just launch ./resmon — it starts with three built-in modules (CPU load, memory, top processes) and needs no config file. From there, make install-config drops a starter config.lua and copies the custom modules (per-core graphs, GPU, temperature, clock frequency) into ~/.config/resmon/mods, so you can mix and match panes.
resmon compiles down to a single self-contained static ELF binary — LuaJIT is linked in, so there's no Lua/Python/Node runtime to install. Almost every data source is read directly via FFI from /proc//sys instead of shelling out to external tools (the one exception being GPU stats, which have no libc/FFI path). Custom modules are plain-text .lua files loaded at startup through the exact same contract as the built-in ones — writing your own panel means dropping one file in a directory, no recompilation needed.
Expand the number of built-in fetchers and modules.
resmon ships with a built-in help/introspection CLI: resmon --help covers the app itself, and resmon -h shows any fetcher's or module's own configuration options and their defaults, without needing to read the source or a config file first.
Every fetcher and module can be sampled or demoed standalone before adding it to your config: -s renders one static sample pane, -d runs a live animated demo full-screen.
Between v0.3.0 and v0.4.0, custom module filenames dropped the "mod_" prefix (e.g. mod_cpu_cores.lua -> cpu_cores.lua). Re-running install.sh --upgrade over an existing v0.3.0 install migrates automatically: it renames the bundled addon files, backs up config.lua, and rewrites it in place to point at the new module names.
Official prebuilt binary + install script from the v0.4.0 GitHub Release, published by the project maintainer.
curl -fsSL https://github.com/pacrox/resmon/releases/download/v0.4.0/resmon-v0.4.0-linux-x86_64.tar.gz | tar xz && ./resmon-v0.4.0-linux-x86_64/install.sh
Added
resmon <addon_name> [-i|-h|-s|-d] inspects,fetch./mod. prefixinfo/opts metadata (plus rangessample fake-data templates for modules), validated by asrc/fake_fetcher.lua: seeded noise generator driving -s/-d fakesample template; history-graph modules get-s render.NONE sentinel for a fetcher = {...} slot that should stay--list (enumerate every installed fetcher/module), --include <path>-o/--options <{lua-table}> (CLI-side config override), -r/--refresh--config-dir/-c/--config-file/--fetchers-dir/--modules-dir) now recognized anywhere on the command line.config/fetcher_addon_sample.lua, config/module_addon_sample.lua,config/ADDON-AUTHORING.md: ready-to-copy addon skeletons and amake install-config and the releaseinstall.sh.dist/install.sh: detects an existing install and its version;config.lua for anything older/unrecognized;--upgrade skips the confirmation prompt.Fixed
prefill_module_history no longer re-polls a real (-f-attached)-d on a module now actually respects its refresh rate, gated per-d/-s on a fetcher now render nested-table values and-s pane width now correctly reaches half the terminal width instead-s history prefill now respects an -o-overridden intervalChanged
mod = "..." values dropped themod_ prefix (mods/clock_graph.lua, mod = "clock_graph");--help/--list output reformatted: a single-i/--info metadata,[VALID]/[FAULT] dependency markers.
By Alvin 
Discussions