Collega i tuoi account.
Capisci cosa stai leggendo.

Requisiti e informazioni sul rilascio

AIUsageWatch è un’app nativa gratuita per la barra dei menu di macOS 14 o successivo. Il rilascio pubblico è in preparazione. Un link verificato per il download sarà aggiunto a questo sito quando disponibile. Gli account dei provider e i costi dei rispettivi piani sono separati.

Sposta l’app rilasciata in Applicazioni prima di attivare Apri al login. L’app risiede nella barra dei menu e non ha bisogno di un’icona nel Dock. Aprire l’app già in esecuzione dal Finder porta le Preferenze in primo piano.

Collega i tuoi provider

1. Codex: installa la CLI di Codex ed effettua l’accesso. Associa l’account alla sua directory di configurazione, di solito ~/.codex. L’app usa l’accesso salvato per quella directory tramite l’app-server locale della CLI.
2. Claude: l’account predefinito ~/.claude usa la tua sessione Safari su claude.ai. Nelle Preferenze, autorizza l’accesso al file di Safari Cookies.binarycookies . Per una directory di configurazione Claude separata, accedi con Claude Code usando quel CLAUDE_CONFIG_DIR; l’app legge il suo .credentials.json.
3. Cursor: accedi su cursor.com in Safari e autorizza l’accesso al file dei cookie di Safari nelle Preferenze. Cursor non usa una directory dell’account per la sua lettura.
4. Grok: seleziona la directory Grok che contiene logs/unified.jsonl. Esegui Grok per aggiornare la lettura di fatturazione in quel log.

L’app legge le informazioni disponibili sulla quota per ogni fonte. Le fonti CLI di Claude e Codex richiedono il rispettivo accesso salvato. L’anteprima del sito non accede mai ai tuoi account.

Account personali e di lavoro insieme

Apri Preferenze… dal menu o premi ⌘,. Ogni account ha un’etichetta, un provider, una directory, un colore e una lettera. Usa + per aggiungere una directory; l’app deduce il provider dai suoi contenuti. Controlla il provider prima di usare il nuovo account.

Per un altro accesso Codex, seleziona il suo CODEX_HOMEseparato. Per un altro accesso Claude, usa un CLAUDE_CONFIG_DIR separato con le proprie credenziali salvate. La sessione Safari di Claude predefinita può essere ambigua quando contiene più organizzazioni; in tal caso usa una directory di configurazione separata. Il sistema di lettura di Cursor usa la sessione Safari disponibile, quindi aggiungere una riga Cursor duplicata non crea un accesso indipendente.

Più account aggiungono colonne, con al massimo tre righe in ogni colonna. Lettere e colori personalizzati aiutano a identificare gli account. Le impostazioni generali includono tempi di aggiornamento, marcatori percentuali, lettere e un avviso per le informazioni supportate sulla scadenza dei reset accumulati di Codex.

Capire le barre

La parte piena indica la quota residua. Allo 0% di quota residua non c’è una parte piena della barra. Il colore identifica un account. Il menu mostra percentuali, orari di reset disponibili, dettagli delle finestre pertinenti e stato della lettura.

Claude include dettagli settimanali e, quando disponibili, delle cinque ore; Codex seleziona il limite settimanale principale. Cursor usa il proprio valore di utilizzo incluso, i cui dati non specificano un periodo di utilizzo. Grok usa un valore di crediti settimanali dal log della CLI. Le percentuali di provider diversi non equivalgono a quantità uguali di token, prompt o dollari.

Individua i reset accumulati di Codex prima della scadenza

Quando Codex comunica i reset accumulati disponibili e le loro date di scadenza, AIUsageWatch può mostrare un indicatore di avviso accanto all’account prima che scada il prossimo reset accumulato. Apri il menu per il numero disponibile e le informazioni sulla scadenza. Un reset accumulato inutilizzato può andare perso alla scadenza; questo è distinto dal normale momento in cui viene ripristinata la quota settimanale.

Attiva Avvisa prima del reset nelle Preferenze e scegli un anticipo di 1–14 giorni. Il valore predefinito è di due giorni, con un punto rosso di avviso; puoi cambiarne il colore. L’indicatore resta visibile quando le lettere degli account sono disattivate. L’avviso dipende dall’app in esecuzione, dagli avvisi attivati e dalla disponibilità di dati di scadenza aggiornati. Non usa automaticamente un reset accumulato e non invia una notifica di sistema.

La richiesta di avvio automatica di Codex

Quando una lettura settimanale di Codex in tempo reale indica il 100% di quota residua, AIUsageWatch invia una piccola richiesta codex exec usando l’accesso CLI salvato per quella directory. Lo scopo è avviare una finestra settimanale che altrimenti potrebbe restare inattiva. Usa il modello predefinito disponibile di Codex e consuma una piccola parte della quota di quell’account.

Un punto rosso segnala l’account mentre la richiesta è in corso o se non riesce. Il menu spiega lo stato e offre la possibilità di riprovare manualmente. L’app conserva in memoria il tentativo per quella finestra settimanale. I controlli ripetuti non inviano altre richieste per il tentativo conservato in memoria; riavviare l’app cancella la memoria e può provocare un’altra richiesta se la lettura in tempo reale indica ancora il 100%.

La lettura di riserva dalle trascrizioni storiche non invia richieste di avvio. L’avvio automatico di Claude non è abilitato nella versione attuale. Questa funzione è separata dalla lettura dell’utilizzo, e le preferenze attuali non offrono un interruttore per l’avvio di Codex.

Un valore è vecchio, manca o è inatteso

• Lettura salvata: l’ultima lettura valida viene memorizzata nella cache sul Mac e ripristinata all’avvio. Il menu indica quanto è vecchia quando un aggiornamento non riesce.
• Limite di frequenza o errore di connessione: i nuovi tentativi vengono sospesi per 15 minuti dopo il raggiungimento di un limite di frequenza e per 2 minuti dopo altri errori. Aggiorna ora ignora quell’attesa.
• Connessione Safari: controlla che l’accesso sia effettuato al provider corretto, verifica l’autorizzazione per il file dei cookie e assicurati che la sessione non sia ambigua.
• Grok: esegui la CLI per registrare una nuova lettura di utilizzo. Una finestra scaduta o un log vecchio vengono mostrati come storici anziché come saldo in tempo reale.
• Codex: assicurati che la CLI sia disponibile e che la directory configurata abbia l’accesso desiderato. La lettura di riserva dalle trascrizioni può mostrare informazioni vecchie se l’app-server non è disponibile.

Gli endpoint e i formati dei dati dei provider possono cambiare. Una lettura non garantisce che un provider accetterà la prossima richiesta. Controlla la pagina dell’account del provider quando un saldo o un reset sembrano errati.

Impostazioni locali e connessioni ai provider

Le preferenze e le letture nella cache sono memorizzate in ~/Library/Application Support/AiUsageWatch/. L’app non legge direttamente il Portachiavi. Le CLI dei provider gestiscono l’accesso secondo le proprie modalità. I sistemi di lettura in tempo reale contattano il provider pertinente usando la sessione o le credenziali esistenti. Leggi questa informativa sulla privacy per capire la distinzione tra dati locali dell’app, connessioni ai provider e messaggi di assistenza.

Segnala un problema

Contatta l’assistenza di AIUsageWatch indicando la versione dell’app, la versione di macOS, il provider, lo stato della lettura e i passaggi per riprodurre il problema. Se usi la modalità diagnostica --dump , controlla l’output prima di inviarlo. Rimuovi token, valori dei cookie, percorsi privati degli account e qualsiasi altra informazione sensibile. Non caricare file di credenziali.