MStat

MStat is a native macOS menu bar utility built with Rust that shows live system stats in the top bar.

It supports:

• CPU usage
• Memory usage
• Storage usage
• Swap usage
• Load average

You can customize:

• Which stats are visible
• Warning and critical thresholds
• Theme (including transparent mode)
• Memory/storage display style (used/total vs %)

Requirements

• macOS
• Rust toolchain (cargo)

Build

cargo build --release

Binary:

target/release/mstat

Run

cargo run --release

Or run the built binary directly:

./target/release/mstat

Install as macOS app (.app)

You can package it as an app bundle:

mkdir -p "$HOME/Applications/MStat.app/Contents/MacOS"
mkdir -p "$HOME/Applications/MStat.app/Contents/Resources"
cp target/release/mstat "$HOME/Applications/MStat.app/Contents/MacOS/mstat"
chmod +x "$HOME/Applications/MStat.app/Contents/MacOS/mstat"

Add Info.plist under:

$HOME/Applications/MStat.app/Contents/Info.plist

Auto-start on login

Create a LaunchAgent:

$HOME/Library/LaunchAgents/com.pnkjsng.mstat.plist

Then load it:

launchctl bootstrap "gui/$(id -u)" "$HOME/Library/LaunchAgents/com.pnkjsng.mstat.plist"
launchctl enable "gui/$(id -u)/com.pnkjsng.mstat"

Install from crates.io

cargo install mstat

Run in background at login

After install, enable startup once:

mstat --install-startup

Check status:

mstat --startup-status

Disable startup:

mstat --uninstall-startup

License

MIT