Skip to content

Releases: arratiabenjamin/claude-code-notifier

v0.3.0 — Übersicht glass widget (BREAKING)

Choose a tag to compare

@arratiabenjamin arratiabenjamin released this 04 May 16:52

⚠️ 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) and RECENTLY COMPLETED (ended within TTL).
  • 🟡 Animated status dots per session: yellow glow when running, green when idle, grey when ended.
  • ⏱️ Live X ago timestamps that update every refresh.
  • 🎛️ Position is yours: edit top/left in the widget's CSS — no recompile, hot reload.

What did NOT change

  • The whole hooks/ layer is identical. ~/.claude/active-sessions.json remains 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

Choose a tag to compare

@arratiabenjamin arratiabenjamin released this 04 May 16:05

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.