armelingu/mac-manager

Mac Manager

Monitor your Mac's health, security and hardware from the terminal — battery alerts, live dashboard, security audit and dev-tooling inventory.

A Python CLI to monitor and take care of your MacBook (Apple Silicon) right from the terminal — battery, system, disk, network — with a live dashboard, automatic daily logging, and native notifications to preserve battery health.

Designed for Apple Silicon MacBook Air/Pro. It also works on Intel, but some metrics (battery capacity, etc.) may vary.

Installation

Homebrew (recommended)

brew install armelingu/tap/mac-manager

The formula lives at armelingu/homebrew-tap. You can also brew install --HEAD armelingu/tap/mac-manager to track the latest commit on main instead of the released version.

pipx / pip

pipx install mac-manager   # isolated, recommended
# or
pip install --user mac-manager

After installation, the mm command is on your PATH. Register the background agents (daily battery log + alerts) with:

mm setup

mm uninstall removes those agents. It does not uninstall the CLI — use brew uninstall mac-manager or pipx uninstall mac-manager for that.

From source

git clone https://github.com/armelingu/mac-manager.git
cd mac-manager
./install.sh

This will:

• create a local venv in .venv/
• install rich and psutil
• create the symlink ~/.local/bin/mm
• register two launchd agents:
• daily log at 09:00 → writes a snapshot to ~/Library/Application Support/mac-manager/battery.csv
• battery alerts every 15 min → native macOS notification

Make sure ~/.local/bin is in your PATH: