Skip to content

feat: add Headroom to Monitoring & Analytics#25

Open
patwalls wants to merge 1 commit into
subinium:mainfrom
patwalls:main
Open

feat: add Headroom to Monitoring & Analytics#25
patwalls wants to merge 1 commit into
subinium:mainfrom
patwalls:main

Conversation

@patwalls

Copy link
Copy Markdown

What

Adds Headroom to the Monitoring & Analytics section alongside CodexBar and Quotio.

Why it fits

Headroom is distinct from the existing entries in a specific way: it monitors Claude Code's rate limits specifically (5-hour session + 7-day weekly usage %), not API usage or multi-provider quota. It reads the numbers Claude Code's own statusLine hook writes to a local file — so it makes zero network calls (verifiable with Little Snitch or nettop).

  • Native Swift/AppKit macOS menu bar app, always visible, zero config
  • Reads ~/.claude/headroom-usage.json written by a Claude Code statusLine hook — no API key, no token
  • Color-coded: calm → amber → red as a limit approaches, with reset countdowns in the dropdown
  • Free, MIT, signed + notarized
  • Install: brew install --cask patwalls/tap/headroom or https://headroom.walls.sh

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant