What is mole-widget?

Mole Widget is a small macOS app that places a live system monitor directly on your desktop. It sits above the wallpaper but below your regular application windows, so it stays visible without getting in the way. You can drag it anywhere on screen, resize it by dragging its right edge, and lock its position so it does not move accidentally. The app runs from the menu bar with no Dock icon and can be set to launch automatically at login. The widget shows several sections of information that refresh every one, two, or five seconds depending on your preference. The CPU section shows overall usage, the three busiest processor cores, load averages, and a small trend graph. The memory section shows how much RAM is in use, cached, and free. Disk shows storage usage and current read and write speeds. The power section covers battery charge level, health, cycle count, and temperature. The network section shows download and upload speeds with small trend graphs, plus the active network interface and local IP address. A process section shows the three applications currently using the most CPU. Clicking any section heading opens Activity Monitor. Installation is available through Homebrew, which builds the app from source on your machine so macOS Gatekeeper does not flag it as an unsigned download. You can also build it from source yourself using just the Xcode Command Line Tools without needing the full Xcode application. The widget checks GitHub for updates every six hours and displays a notice in the interface when one is available. The code is organized as a library containing one module per measurement domain (CPU, memory, disk, power) plus a shared data store and SwiftUI views. The computation is written as pure functions that are unit-tested separately from the parts that talk to system APIs. The project includes 80 tests and requires macOS 14 or later. Mole Widget is released under the MIT license.