{
 "schema_version": 1,
 "generated": "2026-10-31",
 "id": "michellzappa-headroom--check-ai-quota-and-ship-status-from-menu-bar",
 "repo": "michellzappa/headroom",
 "repo_url": "https://github.com/michellzappa/headroom",
 "repo_slug": "michellzappa-headroom",
 "title": "Check AI coding quota and ship status from the menu bar",
 "page_title": "How to check AI coding quota and ship status from the menu bar with Headroom",
 "summary": "Install the Mac app to see remaining quota and failed CI or deploys without leaving your editor.",
 "who": "A developer working in Claude, Codex, or Cursor on a Mac who keeps running into surprise usage limits and forgets to check whether CI or prod is healthy.",
 "problem": "Quota limits, failed Actions runs, and deploy problems are spread across billing pages, gh, and Vercel, so you break focus to check each one.",
 "outcome": "Thin quota tanks and an attention pip sit in the menu bar, and the popover shows Usage, Attention, and Activity from local data only.",
 "steps": [
  "Download Headroom-macOS.zip from the Releases page on the Headroom GitHub repo and open Headroom.app.",
  "Open the menu bar meters and follow the Welcome screen.",
  "Confirm the detected providers, then select Continue. On a Release build the host starts automatically and stays up at login.",
  "Run `curl -s localhost:8737/health | python3 -m json.tool` in Terminal to confirm the host is responding.",
  "Open the popover and check the Attention tab for failed Actions runs, deploys, or monitors."
 ],
 "agent_prompt": "Using the michellzappa/headroom repo, help me set up the Headroom macOS menu bar app for my <tool name> account. Expected output: the menu bar shows quota tanks for the enabled providers, and the local health check returns JSON. Verify by running `curl -s localhost:8737/health | python3 -m json.tool` and confirming it responds.",
 "agents": [
  "any"
 ],
 "difficulty": "Beginner",
 "time": "15 minutes",
 "basis": "readme",
 "caveat": "The README says Headroom reads local state that other tools leave on your Mac and only works for providers already signed in on that machine.",
 "category": "Software and DevOps",
 "tags": [
  "Software and DevOps"
 ],
 "lang": "python",
 "requirements": [
  "macOS 14 or later for the menu bar app",
  "Python 3.9 or later (the bundled host is stdlib only, using /usr/bin/python3)",
  "At least one AI coding tool already signed in locally",
  "Optional: iPhone or iPad on iOS 17 or later, on the same LAN or Tailscale as the Mac",
  "Optional: PlatformIO and a Waveshare ESP32-S3-Touch-AMOLED-1.8 for the desk board"
 ],
 "risk": "sensitive",
 "seen_in_the_wild": false,
 "mentioned_publicly": false,
 "risks": [
  {
   "tag": "credentials",
   "notice": "Headroom reads the auth and CLIs you already have on the Mac, so only install it on machines where you trust local access to those tool sessions."
  }
 ],
 "best": true,
 "score": 1.0,
 "evidence": [],
 "url": "https://dedupedai.com/use-cases/michellzappa-headroom/check-ai-quota-and-ship-status-from-menu-bar/",
 "md": "https://dedupedai.com/use-cases/michellzappa-headroom/check-ai-quota-and-ship-status-from-menu-bar/index.md",
 "disclaimer": "Deduped lists open-source repositories that belong to other people. We do not own, maintain, audit, or vouch for any of them, and a repo appearing here is not an endorsement or a safety check. The use cases, steps, and prompts are written by AI and may be incomplete, outdated, or just wrong. Where a use case is marked \"Seen in the wild\", we link to public posts where someone described something similar, but we have not verified those posts and the use case itself is still our AI's own write-up. Use all of this at your own risk. Only run code, commands, or agents on systems and accounts you are authorized to use, and read the code and every command before you run it, especially anything that touches credentials, files, or the network. Nothing here is professional, security, legal, or financial advice. All trademarks and project names belong to their respective owners, and their use here does not imply affiliation. Content is provided as is, without warranties of any kind. Found a mistake, a safety problem, or something you want removed? Email hello@dedupedai.com and we will look at it promptly.",
 "api": "https://dedupedai.com/api/v1/usecases/michellzappa-headroom--check-ai-quota-and-ship-status-from-menu-bar.json",
 "api_version": "v1"
}