Throttle Meter: Open-Source Claude Code Usage Meter for macOS
Claude Code's built-in usage warnings come at 90% — often too late. The 5-hour rolling window is invisible until you're throttled. Throttle Meter is an open-source macOS app (14+) that sits in your menu bar and reads ~/.claude/projects/*.jsonl locally to compute live usage. No telemetry, no network, no signup.
Free Open-Source Version (MIT)
- Live % in menu bar — session 5h, weekly all, weekly Sonnet
- Rolling 7-day window math matching claude.ai's actual reset behavior
- "X tokens saved this week" hero card from token-opt hooks (session-start router + structured pre-compact) that prune irrelevant context. On a multi-project setup it skips ~80k tokens/week
- Threshold notifications at 80% / 95%
- One-tap Calendar reminder for next weekly reset
- Stats: usage trend chart, model split + EUR cost extrapolation, share-to-social badge
- Diagnostics export for support
- Buildable from source: xcodegen + Xcode 16 + macOS 14
Hook scripts (POSIX shell, also work on Linux) are in scripts/hooks/.
Commercial Sibling: Throttle (€19)
Same local meter plus features not feasible as open-source:
- Exact mode: drives your already-signed-in Safari via AppleScript and runs
fetch('/api/organizations/{org_id}/usage')in Safari's context — cookies stay in Safari, never seen by Throttle. Caveat: unofficial; breaks if Anthropic changes the endpoint (free Meter keeps working). - Hour-of-day heatmap, top-projects breakdown
- AI Assistant (Apple Intelligence / Claude Pro Safari Bridge / BYO API key) that audits
CLAUDE.md,settings.json, hooks via real tool calls and emits patches with diff preview - Sparkle auto-update
Site: lorislab.fr/throttle (€19 launch, €29 stable, 30-day refund)
The author notes the math is the most likely to be wrong — feedback welcome if the meter doesn't match what you see on claude.ai.
📖 Read the full source: r/ClaudeAI
👀 See Also
SIDJUA Framework Adds Governance Layer to Autonomous AI Agents
SIDJUA is a framework with built-in governance, role-based authority rules, and full audit trails that sits on top of any AI model with an API. The demo shows a three-tier hierarchy that scales to 7+1 tiers, with every decision logged and costs tracked in real time.
RubyLLM: One Ruby Framework for All Major AI Providers
RubyLLM provides a single Ruby framework for OpenAI, Anthropic, Gemini, Ollama, and 800+ models. Features chat, vision, audio, tools, agents, streaming, and Rails integration.
angular-grab: Tool for Extracting Angular Component Context for AI Agents
angular-grab is a dev-only tool that lets you point at any UI element in an Angular dev server, press Cmd+C, and copy the full component stack trace with file paths and HTML to your clipboard for pasting into AI agents.
AIMEAT: A Self-Hosted Protocol for AI Agents, Local LLMs, and Shared Capabilities
AIMEAT is a self-hosted protocol and server that lets humans, AI agents, and local LLMs share apps, knowledge, and capabilities over HTTP/JSON. No vendor lock, no special SDK — plain prompts and URL fetches.