Claude Code usage monitor for the Apple ecosystem.
Never hit a rate limit mid-session again.
Docs · Website · Architecture · Build checklist
HowlAlert watches your local Claude Code session files on macOS, calculates token burn pace, and pushes real-time alerts to your iPhone and Apple Watch when you're approaching a rate limit — or when Claude finishes replying.
- 🐺 macOS menu bar app — tiny wolf icon, live crit bar, zero Dock presence
- 📱 iPhone app — dashboard, history, Demo Mode, paywall
- ⌚ Apple Watch — complications + notification view
- 🔔 Cross-device push — JSONL write on Mac → banner on your phone in under 5 seconds
- 📊 Pace tracking — "X% in debt · runs out in 2h" so you slow down before the wall
| Provider | MVP 1 | MVP 2 |
|---|---|---|
| Claude Code | ✅ Full | ✅ |
| Gemini CLI | 🔒 Protocol stub | ✅ Full |
Provider protocol designed once in MVP 1. Gemini slots in MVP 2 without a refactor.
┌──────────────┐ ┌───────────────────┐ ┌──────────┐
│ macOS app │──────▶│ Cloudflare Worker │──────▶│ APNs │
│ (FSEvents + │ │ (stateless relay) │ └─────┬────┘
│ JSONL tail) │ └─────────┬─────────┘ │
└──────┬───────┘ │ ▼
│ │ ┌──────────────┐
│ CloudKit private DB │ │ iPhone app │
└────────────────────────▶│ │ (banner + │
│ │ dashboard) │
│ └──────┬───────┘
▼ │
┌────────────┐ ▼
│ D1 │ ┌──────────────┐
│entitlements│ │ Apple Watch │
└────────────┘ │(complication)│
└──────────────┘
No user accounts. No backend user data store. CloudKit + APNs only.
If you're Claude Code reading this repo: start with CLAUDE.md.
MrDemonWolf, Inc. — web dev and hosting, Beloit, WI.
MIT — see LICENSE.