{"repo":"michellzappa/headroom","free":true,"listed":false,"github":"https://github.com/michellzappa/headroom","clone":"git clone https://github.com/michellzappa/headroom.git","description":"Local-first AI coding quotas and ship status, on your menu bar, iPhone, Watch and an ESP32 desk display.","language":"Python","stars":262,"topics":["ambient-display","arduino","claude-code","developer-tools","esp32","ios","local-first","macos","menubar","swift"],"license":"MIT","category":"mobile-apps","readme_excerpt":"Headroom Your AI coding quotas and ship status — in the menu bar, on your phone, and optionally on the desk. When you're deep in Claude, Codex, or Cursor, you shouldn't have to dig through billing pages, gh , and Vercel to answer: Am I about to hit a limit? Did CI go red? Is prod healthy? Headroom is a local-first macOS menu bar app (+ optional iPhone / Watch). One Python host on your Mac reads the auth and CLIs you already have and serves a single JSON feed. No Headroom cloud account — tokens stay on the machine. Surface What you see --- --- Menu bar Thin remaining-quota tanks for the first three enabled providers + amber/red attention pip Popover Usage (rings, daily burn, spend), Attention , Activity (Recent feed + service panels) Notification Center Same widget as the iPhone: rings small, combined burndown medium iPhone / iPad Same three tabs — Usage, Attention, Activity — plus Settings, notifications, widgets Apple Watch Two complications: rings, or the week's burndown ESP32 desk board (optional) Same three rings + burndown on a Waveshare AMOLED — docs/esp32.md Why it exists - Quota anxiety — session / weekly windows, pace, and spend on one ring (and a menu-bar tick per provider in focus). - Ship status ambient — failed Actions, deploys, and monitors as an Attention pip and queue, not another tab. - Agents away from the desk — approve, deny, or reply to Claude / Codex requests from Attention on iPhone (Headroom answers; it does not start work). - Local-first — credentials","default_branch":null,"files":null,"tree":[],"storefront":"/r/michellzappa","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/michellzappa/headroom/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}