App nativa per la menu bar di macOS

Sai esattamente quanta AI ti resta.

Headroom mostra quanto resta dei tuoi limiti Codex e Claude Code, quando si azzera ogni finestra, e ti avvisa prima che un run lungo muoia al 99%.

macOS 14+ · Apple Silicon e Intel · niente account, niente telemetria

Headroom 2s ago
Claude Code MAX
Session (5h)62%left
resets in 1h 11m · 11:14
Week (Fable)19%left
resets in 4d 8h · Mon 11:00
{} Codex PLUS
Session (5h)66%left
resets in 2h 39m · 12:42
Week42%left
resets in 3d 4h · Sun 15:02

È una replica viva: passa sulle righe, premi refresh. L’app vera è identica al pixel.

Come funziona

Endpoint ufficiali. I login che hai già. Nient’altro.

Niente scraping, niente proxy, niente chiavi API da incollare. Headroom legge gli stessi dati che leggono i tool ufficiali dei vendor, con le credenziali che le tue CLI hanno già su questo Mac.

01

Tutte le finestre, un colpo d’occhio

Finestre di sessione e settimanali per Codex e Claude Code, compresi i tetti settimanali per modello. Ogni indicatore mostra la percentuale rimasta, le tacche di soglia e l’ora esatta del reset.

02

Il limite più stretto vive nella tua menu bar

Headroom trova la finestra più vincolante e ne fissa la percentuale accanto all’orologio. Diventa arancione al 75% e rossa al 90%: il muro non ti sorprende mai.

03

Un HUD che galleggia sopra l’editor

Un pannello sempre in primo piano, trascinabile, visibile in ogni Spazio. Lo attivi ovunque con ⌃⌥J, lo agganci a qualsiasi angolo e guardi le barre muoversi mentre i tuoi agent lavorano.

HUD flottante di Headroom con un indicatore per finestra
04

Avvisato prima del muro, non dopo

Notifiche native alle soglie che scegli tu. Lancia il run lungo solo quando sai che può finire.

Claude Code: occhio
Week (Fable) è all’81%. Si azzera giovedì alle 16:43.
Codex: limite quasi raggiunto
Session (5h) è al 92%. Si azzera alle 10:23.
05

Un check di salute per il tuo terminale

Lo stesso motore è anche un comando: Headroom --check stampa ogni finestra in testo semplice. Perfetto per script, status line di tmux o un’occhiata via SSH.

Privacy

Local-first non è una funzione. È l’architettura.

  • Le credenziali non si muovono. Headroom legge i token che le tue CLI hanno già salvato e parla solo con gli endpoint ufficiali dei vendor.
  • Zero telemetria. Nessun SDK di analytics, nessun crash reporter, nessun account, nessun nostro server in mezzo.
  • Verificabile. Una piccola app Swift nativa che leggi in un pomeriggio. Niente Electron, niente browser incorporato.

Prezzi

Open source. Paghi la comodità.

Il codice è su GitHub con licenza MIT: compilalo tu, gratis, per sempre. Oppure prendi la build pronta e sostieni il progetto.

Source

Per chi i propri tool li legge

Free

Licenza MIT, per sempre

  • Tutte le funzioni, senza eccezioni
  • ./build-app.sh e sei operativo
  • Controlla tu stesso le ~1500 righe
Vedi su GitHub
Salta la toolchain

App

Firmata, notarizzata, pronta in 10 secondi

€4.99 one-time

paga di più se ti salva un run bruciato: succederà

  • Build notarizzata, nessun avviso di Gatekeeper
  • Tutti gli aggiornamenti 1.x inclusi
  • Tiene vivo il progetto
Avvisami quando esce · 4,99 €

Una build firmata e notarizzata è in arrivo. Iscriviti alla lista d’attesa e la ricevi il giorno in cui esce; il sorgente si compila già oggi.
Impaziente e a tuo agio con tasto destro → Apri? Scarica la build non firmata (gratis durante la beta).

FAQ

Domande legittime

Come legge Headroom il mio utilizzo?

Chiama gli endpoint ufficiali (quello di OpenAI per Codex, l’API OAuth di Anthropic per Claude Code) con il login che la tua CLI ha già su questo Mac. Sono gli stessi dati che ti mostrano codex e claude /status, letti in circa 300 ms.

Qualcosa lascia il mio Mac?

Solo le richieste HTTPS verso OpenAI e Anthropic che le tue CLI fanno già. Non esiste un server di Headroom, niente analytics, niente account.

Perché macOS chiede l’accesso al portachiavi al primo avvio?

Claude Code salva il login nel portachiavi di macOS. Headroom chiede una volta il permesso di lettura: clicca “Consenti sempre” e non te lo richiederà più. Puoi anche negarlo: Headroom mostrerà semplicemente Claude come non disponibile.

È davvero open source?

Sì, licenza MIT su GitHub. La build a pagamento è lo stesso identico codice, compilato, firmato e notarizzato perché macOS lo apra senza avvisi. Se hai la toolchain Swift, ./build-app.sh ti dà un’app identica, gratis.

Quali tool sono supportati?

Oggi Codex (piani ChatGPT) e Claude Code. Il livello provider è volutamente piccolo; Gemini CLI e Cursor sono in roadmap.

È affiliato a OpenAI o Anthropic?

No. Headroom è una utility indipendente. Codex, ChatGPT, Claude e Claude Code sono marchi dei rispettivi proprietari.