Skip to content

Mac Vitals 0.1.0

Choose a tag to compare

@netsatsawat netsatsawat released this 08 Sep 04:24
· 16 commits to main since this release

First public cut. A live CPU, GPU, memory, and power monitor for Apple Silicon that reads everything as a normal user, with no password, no dependencies, and no helper daemon. The same engine speaks MCP, so a coding agent can read the machine too.

Highlights

  • Four faces over one engine: a menu-bar readout, a popover, a floating widget, and a full window that charts every metric from one minute to a year, plus year-to-date.
  • CPU (overall, E and P clusters, per core), GPU, memory, per-rail power, network, disk, battery, temperature, and fan.
  • GPU utilization calibrated against powermetrics on the M5. GPU power in watts is exact.
  • Task traces that measure what a build or a run cost, in the app, the CLI, and over MCP.
  • History persisted across restarts at three resolutions, so short ranges no longer regather on launch and the long ranges fill from what is already on disk. See docs/history-persistence.md.
  • Read-only MCP server: get_vitals, get_vitals_history, start_trace, stop_trace. See docs/MCP.md.

Install

Build from source. Needs macOS 14 or later on Apple Silicon and the Xcode Command Line Tools.

git clone https://github.com/netsatsawat/mac-vitals.git
cd mac-vitals
./scripts/build-app.sh
open build/MacVitals.app

Full notes in the CHANGELOG.