Releases: arratiabenjamin/claude-code-notifier
Release list
v0.3.0 — Übersicht glass widget (BREAKING)
⚠️ Breaking change
The UI stack has been replaced. SketchyBar is out, Übersicht is in.
If you're on v0.2.x, run ./install.sh again to switch over.
brew install --cask ubersicht is now required.
Optionally: brew uninstall sketchybar to clean up.
Why?
SketchyBar can only draw items inside its own bar (top or bottom of the screen). It can't float a widget freely, can't apply native NSVisualEffectView blur, and ends up either hiding parts of the macOS menu bar or crammed into a corner. Übersicht solves all three: HTML/CSS/JSX widgets positionable to any pixel, with real backdrop-filter: blur() glass and full styling control.
What's new
- 🪟 Glass-effect floating widget:
backdrop-filter: blur(28px) saturate(180%), soft shadow, rounded 16px corners. Looks like a Control Center widget. - 🎯 Two segmented sections:
ACTIVE(running + idle) andRECENTLY COMPLETED(ended within TTL). - 🟡 Animated status dots per session: yellow glow when running, green when idle, grey when ended.
- ⏱️ Live
X agotimestamps that update every refresh. - 🎛️ Position is yours: edit
top/leftin the widget's CSS — no recompile, hot reload.
What did NOT change
- The whole
hooks/layer is identical.~/.claude/active-sessions.jsonremains the stable contract between backend and UI. - Notification behavior (90s threshold, multi-session rule, disable flag) is the same.
What's next (probably v0.4.0)
A native Swift app that does the same thing with NSVisualEffectView, always-on-top, and notch awareness. The state file contract means we can ship that without touching the hooks.
v0.2.0 — Pill widget + ended session tracking
Highlights
🎨 New floating pill widget
The bar is now fully transparent — macOS's native menu bar is no longer covered. Only the rounded pill item shows on the right side, with bold icon and clean typography.
📊 Track recently completed sessions
SessionEnd no longer removes entries from state — it marks them as status: "ended" with an ended_at timestamp. The popup gains a RECENTLY COMPLETED section so you can glance back at what just finished. New CLAUDE_ENDED_TTL env var (default 1 hour) controls how long they stay visible.
🚦 Four-state color
Grey (nothing) · Blue (only ended) · Green (idle present) · Amber (turn running).
🐛 Fixed
notify-stop.sh was counting ended sessions toward the multi-session notification rule, which would have caused noisy notifications.
See CHANGELOG.md for the full diff.