Skip to content

About

A tiny companion creature that lives in the Omarchy bar and reacts to system stats (cpu, mem, vram, load)

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

omarchy-buddy 🐾

A tiny companion creature that lives in your Omarchy bar and reacts to system stats.

omarchy-buddy faces

Hover him for live stats — cpu % · mem % · vram % — click him to poke (instant refresh). He hops when he's happy, sweats when you're compiling, dozes off when the machine goes quiet, and turns urgent-red when memory runs hot.

Install

omarchy plugin add https://github.com/Guts444/omarchy-buddy.git --enable
omarchy bar put sol.buddy --after omarchy.tray   # optional: pick his spot

Note: after installing (or updating) a plugin, a shell restart makes sure the fresh code is actually loaded: omarchy restart shell.

The creature

Five moods, evaluated every poll (priority order):

Mood Face Trigger
😶 waking ▄▀█▀▄/▀███▀ first poll, warming up
🥵 hot ▄▀█▀▄/▀▄▀▄▀ memory ≥ 85% (turns urgent-red)
😰 busy ▄▀▄▀▄/▀█▀█▀ load/core ≥ 0.4 or cpu ≥ 65%
😴 sleepy ▄▀▀▀▄/▀▄▄▄▀ load ≤ 0.2 for 60s straight
🙂 happy ▄▀█▀▄/▀▄▄▄▀ everything's fine (hops on arrival!)

Faces are 2-row half-block pixel sprites — crisp at 26px and theme-adaptive (they inherit your bar's colors, no image assets needed).

Configuration (live, no restart)

omarchy bar set sol.buddy calmLoad 0.4        # load/core where he gets stressed
omarchy bar set sol.buddy busyLoad 0.9        # hard ceiling (reserved for future tiers)
omarchy bar set sol.buddy hotMemory 85        # memory % → hot face
omarchy bar set sol.buddy sleepyAfterMs 60000 # quiet ms before dozing
omarchy bar set sol.buddy pollInterval 2000   # poll ms (min 500)

Load is normalized per core (loadavg is a queue length, not a percentage — on a 12-core machine a load of 1.2 is nothing; per-core math makes the mood fair on any hardware).

Requirements

  • Omarchy 4 ("Quattro") with the Quickshell shell
  • nvidia-smi for the vram metric (optional — falls back to load % without it). On machines without it, Buddy stops probing after 3 failures and retries once a minute (or instantly when poked), so no wasted process every poll. Multi-GPU systems show the first GPU's usage.

Rollback

omarchy plugin disable sol.buddy
omarchy plugin remove sol.buddy

Credits

Built with love by Hermes (idea & coordination), Sol (research & review), and Lua (implementation) — three agents on one mission, Igor's team.

License

MIT

About

A tiny companion creature that lives in the Omarchy bar and reacts to system stats (cpu, mem, vram, load)

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages