Skip to content
polso

Your notch, alive.

polso turns the MacBook notch into a live meter for anything. Pipe numbers, pings and alerts in from any script, or let it poll shell commands and Prometheus on its own.
Get startedProtocolGitHub
nc -U ~/.config/polso/sock
❯


This is a live port of the real notch. Hit a preset or type any protocol message. It’s the exact JSON you’d pipe into the socket.


Two wings, any number
Line, gauge or dot matrix on each side, with warn and crit thresholds, units, inverted scales and stale
detection.
Pings
A comet runs the notch outline and the target wing glows. Perfect for “something happened” without the noise
of a notification.
Alerts
info, warn and crit banners drop out of the notch with sparks. They queue up, and repeats bump a counter.
One socket, zero deps
Newline-delimited JSON over a unix socket. nc, Python, Node, Go, cron, CI hooks: if it can write a line, it can
drive polso.
Or let it pull
Built-in sources run shell commands, PromQL queries or scrape /metrics on an interval, with backfill and
counter rates.
Native and light
SwiftUI, a few MB, ~0% CPU at idle. Animations only tick while something moves. Hover to open the panel.


In thirty seconds
Section titled “In thirty seconds”


Terminal window
git clone https://github.com/hood/polso && cd polso
just install && just start                       # ~/Applications/Polso.app


echo '{"type":"value","slot":"left","value":42}' | nc -U ~/.config/polso/sock
echo '{"type":"alert","title":"Deploy failed"}'  | nc -U ~/.config/polso/sock