Omahub
← All plugins
E

Memory Usage

by EGOIST

Compact memory usage with an iStat-inspired pressure, composition, process, paging, and swap panel.

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

None
Risk level
None
Analyzed commit
320a8de
Scanned
1 month ago

No potentially dangerous behavior detected in the analyzed commit.

Automated analysis only — not a security guarantee.

AI advisory review

No obvious issues detected

Language-model assessment · ~deepseek/deepseek-v4-flash-latest — advisory only

None
AI risk level
None
Recommendation
install
Model
~deepseek/deepseek-v4-flash-latest
Analyzed commit
320a8de
Reviewed
1 month ago

The plugin is a straightforward memory usage widget that reads system statistics from /proc and ps, displaying them in QML. It performs no network access, no writes, and no privileged operations. The deterministic scan found no issues.

How this check works

This review combines the deterministic scan (the rule-based results above) with an independent look at the plugin's code by a language model. The model reads a trimmed sample of the repository's files, the manifest, and the README, then gives a plain-language risk level and a recommendation: install (no notable danger), review (look closer first), or avoid (clearly dangerous).

It runs on the same analyzed commit as the deterministic scan and is strictly advisory — it is not a security guarantee and never blocks a plugin by itself. A human moderator still reviews plugins before they are listed.

AI advisory only — automated analysis, not a security guarantee.

Install
$ omarchy plugin add https://github.com/egoist/omarchy-memory-usage --enable
Widgets #bar #quickshell #system

Memory Usage for Omarchy

An iStat Menus-inspired Omarchy Quattro bar widget for live RAM usage, Linux memory pressure, memory composition, top processes, paging activity, and swap.

Memory Usage preview

Features

  • Compact vertical MEM label and adjacent meter, centered in a standard icon slot, that fills upward with used RAM
  • Native Quattro popout with pressure and memory rings
  • Applications, kernel, cache, and free-memory composition
  • Top processes grouped by executable name, with application icons
  • Live swap-in and swap-out rates plus total swap usage
  • Theme-aware panel text and native keyboard/panel switching behavior

Install

omarchy plugin add https://github.com/egoist/omarchy-memory-usage.git --enable

The widget lands in the right section of the bar. Move it if needed:

omarchy bar move dev.egoist.memory-usage --section right

Configure

Set the fixed horizontal widget width (default 27, the standard icon slot):

omarchy bar set dev.egoist.memory-usage width 27

Set the number of process rows (default 5, range 1–10):

omarchy bar set dev.egoist.memory-usage processCount 5

How the metrics work

Overall usage is MemTotal - MemAvailable from /proc/meminfo, matching modern Linux's view of memory that cannot be readily reclaimed. The composition ring is a complete physical-memory breakdown:

  • Applications: anonymous pages plus shared memory
  • Kernel: the remaining non-cache, non-free physical memory
  • Cache: page cache plus reclaimable slab, excluding shared memory
  • Free: completely unused physical memory

Pressure is Linux PSI's some avg10: the percentage of the last ten seconds during which at least one task was stalled waiting for memory. It is intentionally not derived from the usage percentage.

Process totals are resident set size (RSS), grouped by executable name. Shared pages can appear in more than one process, so process rows should not be added up to reproduce overall usage.

Dependencies and security

The plugin runs unsandboxed with your user permissions, like every Omarchy shell plugin. It does not use sudo, install packages, start services, or access the network.

It reads Linux's /proc statistics and uses commands included with a standard Omarchy installation: Bash, awk, ps, sort, head, getconf, date, and jq.

Update

omarchy plugin update dev.egoist.memory-usage

Remove

omarchy plugin remove dev.egoist.memory-usage

License

MIT