Connectez vos comptes.
Comprenez les relevés affichés.

Configuration requise et informations de sortie

AIUsageWatch est une app native gratuite dans la barre des menus pour macOS 14 ou version ultérieure. La sortie publique est en préparation. Un lien de téléchargement vérifié sera ajouté à ce site dès qu’il sera disponible. Vos comptes fournisseurs et leurs propres frais d’abonnement sont distincts.

Déplacez l’app publiée dans Applications avant d’activer Ouvrir à l’ouverture de session. L’app réside dans la barre des menus et n’a pas besoin d’icône dans le Dock. Ouvrir l’app déjà en cours d’exécution depuis le Finder fait passer les Préférences au premier plan.

Connectez vos fournisseurs

1. Codex : installez la CLI Codex et connectez-vous. Indiquez au compte son répertoire de configuration, généralement ~/.codex. L’app utilise la connexion enregistrée de ce répertoire via l’app-server local de la CLI.
2. Claude : le compte par défaut ~/.claude utilise votre session Safari sur claude.ai. Dans les Préférences, autorisez l’accès au fichier Cookies.binarycookies de Safari. Pour un répertoire de configuration Claude distinct, connectez-vous avec Claude Code en utilisant ce CLAUDE_CONFIG_DIR; l’app lit son fichier .credentials.json.
3. Cursor : connectez-vous à cursor.com dans Safari et autorisez l’accès au fichier de cookies de Safari dans les Préférences. Cursor n’utilise pas de répertoire de compte pour son relevé.
4. Grok : sélectionnez le répertoire Grok contenant logs/unified.jsonl. Exécutez Grok pour mettre à jour le relevé de facturation de ce journal.

L’app lit les informations de quota disponibles pour chaque source. Les sources CLI Claude et Codex nécessitent la connexion enregistrée correspondante. L’aperçu du site n’accède jamais à vos comptes.

Comptes personnels et professionnels ensemble

Ouvrez Préférences… depuis le menu, ou appuyez sur ⌘,. Chaque compte a un libellé, un fournisseur, un répertoire, une couleur et une lettre. Utilisez + pour ajouter un répertoire ; l’app déduit le fournisseur de son contenu. Vérifiez le fournisseur avant d’utiliser le nouveau compte.

Pour une autre connexion Codex, sélectionnez son CODEX_HOMEdistinct. Pour une autre connexion Claude, utilisez un CLAUDE_CONFIG_DIR distinct avec ses propres identifiants enregistrés. La session Safari Claude par défaut peut être ambiguë lorsqu’elle contient plusieurs organisations ; utilisez alors un répertoire de configuration distinct. Le lecteur Cursor utilise la session Safari disponible : ajouter une ligne Cursor en double ne crée donc pas de connexion indépendante.

L’ajout de comptes crée des colonnes, avec au maximum trois lignes par colonne. Les lettres et couleurs personnalisées aident à identifier les comptes. Les réglages généraux comprennent la fréquence d’actualisation, les repères de pourcentage, les lettres et une alerte pour les informations d’expiration des réinitialisations Codex mises en réserve prises en charge.

Comprendre les barres

La partie remplie représente le quota restant. À 0 % restants, il n’y a plus de barre remplie. La couleur identifie le compte. Le menu affiche les pourcentages, les horaires de réinitialisation disponibles, les détails pertinents des périodes et l’état des relevés.

Claude inclut des détails hebdomadaires et, lorsqu’ils sont disponibles, sur les périodes de cinq heures ; Codex sélectionne la limite hebdomadaire principale. Cursor utilise son propre volume d’utilisation inclus, dont les données ne précisent pas de période d’utilisation. Grok utilise une valeur de crédits hebdomadaires provenant du journal de la CLI. Les pourcentages des différents fournisseurs ne correspondent pas à des nombres équivalents de tokens, de requêtes ou de dollars.

Repérez les réinitialisations Codex mises en réserve avant leur expiration

Lorsque Codex indique des réinitialisations mises en réserve disponibles et leurs dates d’expiration, AIUsageWatch peut afficher un point d’alerte à côté du compte avant que la prochaine n’expire. Ouvrez le menu pour consulter le nombre disponible et les informations d’expiration. Une réinitialisation mise en réserve non utilisée peut être perdue à son expiration ; cela est distinct de l’horaire normal de réinitialisation de votre quota hebdomadaire.

Activez Avertir avant la réinitialisation dans les Préférences et choisissez un délai de 1 à 14 jours à l’avance. Le délai par défaut est de deux jours, avec un point d’alerte rouge ; vous pouvez changer sa couleur. Le point reste visible lorsque les lettres des comptes sont désactivées. L’alerte nécessite que l’app soit en cours d’exécution, que les alertes soient activées et que les données d’expiration soient disponibles et à jour. Elle n’utilise pas automatiquement de réinitialisation mise en réserve et n’envoie pas de notification système.

La requête de démarrage automatique de Codex

Lorsqu’un relevé hebdomadaire Codex en direct indique 100 % restants, AIUsageWatch envoie une petite requête codex exec avec la connexion CLI enregistrée dans ce répertoire. Son objectif est de démarrer une période hebdomadaire qui pourrait autrement rester inactive. Elle utilise le modèle disponible par défaut de Codex et consomme une petite part du quota de ce compte.

Un point rouge signale le compte pendant la requête ou en cas d’échec. Le menu explique l’état et permet de réessayer manuellement. L’app mémorise la tentative en mémoire vive pour cette période hebdomadaire. Les interrogations répétées n’envoient pas d’autres requêtes pour cette tentative mémorisée ; relancer l’app efface cette mémoire et peut entraîner une autre requête si le relevé en direct indique toujours 100 %.

Le recours aux transcriptions historiques n’envoie pas de requêtes de démarrage. Le démarrage automatique de Claude n’est pas activé dans la version actuelle. Cette opération est distincte de la lecture de l’utilisation, et les préférences actuelles ne proposent pas d’interrupteur pour la requête de démarrage Codex.

Une valeur est ancienne, absente ou inattendue

• Relevé enregistré : le dernier relevé valide est mis en cache sur votre Mac et restauré au lancement. Le menu indique son ancienneté lorsqu’une actualisation échoue.
• Limite de fréquence ou échec de connexion : les nouvelles tentatives sont espacées de 15 minutes après une limite de fréquence et de 2 minutes après les autres erreurs. Actualiser maintenant ignore ce délai d’attente.
• Connexion Safari : vérifiez que vous êtes connecté au bon fournisseur, contrôlez l’autorisation d’accès au fichier de cookies et assurez-vous que la session n’est pas ambiguë.
• Grok : exécutez la CLI pour enregistrer un nouveau relevé d’utilisation. Une période expirée ou un ancien journal est présenté comme historique et non comme un solde en direct.
• Codex : vérifiez que la CLI est disponible et que le répertoire configuré contient la connexion souhaitée. Le recours aux transcriptions peut afficher des informations anciennes si l’app-server est indisponible.

Les points d’accès et les formats de données des fournisseurs peuvent changer. Un relevé ne garantit pas qu’un fournisseur acceptera la prochaine requête. Consultez la page de votre compte chez le fournisseur si un solde ou une réinitialisation semble incorrect.

Paramètres locaux et connexions aux fournisseurs

Les préférences et les relevés en cache se trouvent dans ~/Library/Application Support/AiUsageWatch/. L’app ne lit pas directement le Trousseau. Les CLI des fournisseurs gèrent elles-mêmes leurs connexions. Les lecteurs en direct contactent le fournisseur concerné avec la session ou les identifiants existants. Lisez la politique de confidentialité pour comprendre la distinction entre le stockage local de l’app, les connexions aux fournisseurs et les messages d’assistance.

Signaler un problème

Contactez l’assistance AIUsageWatch en indiquant la version de l’app, la version de macOS, le fournisseur, l’état du relevé et les étapes permettant de reproduire le problème. Si vous utilisez le mode de diagnostic --dump , vérifiez sa sortie avant de l’envoyer. Supprimez les jetons d’accès, valeurs de cookies, chemins privés des comptes et toute autre information sensible. Ne transmettez pas de fichiers d’identifiants.