Utility nativa macOS · 2026

UsageBar

I limiti di utilizzo dove servono: direttamente nella barra dei menu.

UsageBar è costruita principalmente intorno a OpenAI Codex e mostra la percentuale reale rimanente delle finestre da 5 ore e 7 giorni dell’account autenticato, con supporto opzionale per GitHub Copilot.

Scarica v0.2.0 Vedi sorgente

Versione: UsageBar v0.2.0
Piattaforma: macOS 13+
Provider: OpenAI Codex · GitHub Copilot
Licenza: MIT

UsageBar mostrata nella barra dei menu di macOS con la sua interfaccia reale.

Scopo

Tenere la quota visibile senza aprire un’altra dashboard.

Il titolo compatto nella barra dei menu resta focalizzato sul provider selezionato e sulla quota rimanente. I countdown di reset di Codex compaiono solo nel menu a tendina, così la vista persistente rimane volutamente minimale.

Finestra breve Codex

Mostra la percentuale reale rimanente riportata per l’account Codex autenticato.

Finestra settimanale Codex

Mostra la percentuale reale rimanente riportata per l’account Codex autenticato.

Provider

Due provider. Nessun livello generico basato su API key.

Codex è il provider principale e predefinito. GitHub Copilot è opzionale. Il provider selezionato persiste tra gli avvii e ogni provider mantiene una snapshot cache isolata, così un errore non cancella l’ultima lettura valida dell’altro.

OpenAI Codex

UsageBar legge la quota tramite l’interfaccia JSON-RPC ufficiale codex app-server usando lo stato di autenticazione Codex già esistente.

GitHub Copilot

UsageBar usa la GitHub CLI già autenticata per la richiesta di compatibilità della quota Copilot. Non legge né salva il token GitHub.

Percorso quota

L’autenticazione resta gestita dagli strumenti ufficiali.

Codex segue l’handshake app-server initialize → initialized → account/rateLimits/read. Copilot resta isolato nella propria implementazione provider e usa l’autenticazione già posseduta dalla GitHub CLI.

OpenAI Codex
  official Codex auth
        │
        ▼
  codex app-server
        │
initialize → initialized
        │
account/rateLimits/read
        │
        ▼
     UsageBar

GitHub Copilot
  GitHub CLI auth
        │
        ▼
isolated Copilot provider
        │
        ▼
     UsageBar

Privacy

Niente API key. Nessun account UsageBar. Nessun backend.

UsageBar non chiede mai all’utente di incollare credenziali e non usa richieste di generazione del modello per ottenere i dati di quota.

Non legge prompt, conversazioni, sessioni o file di autenticazione Codex.
Non legge, copia o salva token GitHub.
Nessuna telemetria, analytics, tracking o sincronizzazione remota.
Nessun server UsageBar e nessun archivio credenziali.

Stati provider

Lo stato Connected richiede una vera lettura della quota.

Connected

Not installed

Needs login

Temporarily unavailable

Stato verificato

v0.2.0 è stata testata su entrambi i provider configurati.

Coverage fixture, test live opt-in dei provider, build con warnings-as-errors, packaging della release e validazione installazione sono documentati separatamente nella repository pubblica.

18 / 0
Test eseguiti / errori: PASS
Lettura live quota Codex: PASS
Lettura live quota Copilot: 0,0%
CPU idle nel run di validazione

Distribuzione

Una utility macOS compilata, pronta da installare.

La release viene distribuita come ZIP tramite GitHub Releases. L’app gira nella barra dei menu e il bundle validato è configurato senza icona nel Dock.

Scarica v0.2.0

Scarica UsageBar-v0.2.0-macOS.zip.
Estrai UsageBar.app.
Sposta UsageBar.app in Applicazioni.
Avviala, poi usa la finestra Providers per verificare Codex o l’opzionale GitHub Copilot.

Il run di validazione v0.2.0 non ha automatizzato il toggle visibile Launch at Login, la voce Refresh manuale o lo switching visibile dei provider, anche se switching, refresh e persistenza sottostanti sono coperti dai test.

Quota Codex a colpo d’occhio. Copilot quando serve.

UsageBar v0.2.0 è disponibile per macOS 13+ come utility open source con licenza MIT.

Scarica v0.2.0 Vedi sorgente