Skip to content

README.fr.md

Latest commit

 

History

History
127 lines (91 loc) · 6.1 KB

README.fr.md

File metadata and controls

127 lines (91 loc) · 6.1 KB

⚡ Codex Rate Watcher

Ne soyez plus jamais limité en pleine session

Une application macOS ultra-rapide dans la barre de menu qui surveille en temps réel l'utilisation des limites de débit OpenAI Codex (ChatGPT Pro / Team) — avec gestion multi-comptes, prédictions de consommation et changement intelligent.

en zh-CN ja ko es fr de

macOS Swift License Zero Dependencies

Codex Rate Watcher — application macOS de barre de menu pour surveiller les limites de débit OpenAI Codex ChatGPT en temps réel

Surveillance de quota en temps réel · Prédiction de consommation · Changement multi-comptes · Compte à rebours de réinitialisation

🤯 Le Problème

Vous êtes en plein flow, en pair-programming avec Codex, en train de refactoriser un module critique — et soudain vous heurtez le mur de la limite de débit. Pas d'avertissement. Pas de compte à rebours. Juste un froid 429 Too Many Requests.

Vous attendez. Vous rafraîchissez. Vous n'avez aucune idée de quand votre quota se réinitialise ni à quelle vitesse vous l'avez consommé.

Codex Rate Watcher résout ce problème. Définitivement.

🎯 Ce Qu'il Fait

Codex Rate Watcher réside dans votre barre de menu macOS et vous offre une visibilité totale sur l'utilisation des limites de débit OpenAI Codex / ChatGPT :

Fonctionnalité Description
📊 Suivi en temps réel Surveillez les limites 5h primaire, hebdomadaire et de revue de code simultanément
🔥 Prédiction de consommation Prédit exactement quand votre quota sera épuisé
⏰ Compte à rebours Chaque carte affiche son heure de réinitialisation
👥 Gestion multi-comptes Capture automatique des snapshots ; gérez Plus et Team en parallèle
🧠 Changement intelligent Algorithme de scoring pondéré recommande le meilleur compte
🔄 Réconciliation automatique Snapshots orphelins auto-découverts et enregistrés au démarrage
🏷️ Badges de plan Affiche clairement Plus / Team dans l'interface
🎨 UI thème sombre Design inspiré de Linear avec cartes de quota colorées

✨ Fonctionnalités Clés

  • Statut barre de menu — pourcentage restant toujours visible
  • Suivi tridimensionnel — fenêtre 5h + hebdomadaire + revue de code
  • Prédictions de consommation — régression linéaire sur les échantillons d'utilisation
  • Heure de réinitialisation sur chaque carte — même pour les comptes actifs
  • Tri de disponibilité à 5 niveaux — disponible → faible → bloqué → erreur → non vérifié
  • Changement en un clic — sauvegarde automatique avant le changement
  • Surveillance du fichier auth — détecte codex login en temps réel via kqueue
  • Réconciliation des snapshots orphelins — ne perdez jamais un compte
  • Mode fenêtre de débogage — drapeau --window pour fenêtre autonome
  • 🔔 Système d'alertes intelligent — notifications configurables par seuil (50 %, 30 %, 15 %, 5 %), alertes natives macOS, déduplication par fenêtre de réinitialisation et alertes sonores selon l'urgence
  • 🎨 Icône dynamique dans la barre de menus — change de couleur en temps réel selon la santé du quota (vert → jaune → orange → rouge), retour visuel instantané sans ouvrir l'app
  • Zéro dépendance — frameworks système Apple purs

📥 Téléchargement

Téléchargez les bundles .app pré-compilés sur la page Releases — aucun Xcode ni toolchain Swift requis.

Puce Téléchargement
Apple Silicon (M1 / M2 / M3 / M4) Dernière version — Apple Silicon
Intel (x86_64) Dernière version — Intel
  1. Téléchargez le .zip correspondant à la puce de votre Mac
  2. Décompressez et glissez Codex Rate Watcher.app dans /Applications
  3. Lancez — l'app apparaît dans la barre de menus (pas dans le Dock)
  4. Vérifiez que Codex CLI est connecté (~/.codex/auth.json)

Premier lancement : L'app n'est pas notariée. Clic droit → Ouvrir, ou Réglages → Confidentialité → Ouvrir quand même.

🚀 Compiler depuis les sources

Prérequis

  • macOS 14 (Sonoma) ou ultérieur
  • Codex CLI installé et connecté
  • Swift 6.2+ (Xcode 26 ou swift.org)

Compiler et exécuter

git clone https://github.com/sinoon/codex-rate-watcher.git
cd codex-rate-watcher
swift run

⚙️ Stack Technique

Composant Technologie
Langage Swift 6.2
Framework UI AppKit (code uniquement, sans SwiftUI/XIB)
Système de build Swift Package Manager
Concurrence Swift Concurrency (async/await, Actor)
Réseau URLSession
Cryptographie CryptoKit (empreinte SHA256)
Surveillance fichiers GCD DispatchSource (kqueue)
Dépendances Aucune — frameworks système purs

🤝 Contribuer

Les contributions sont les bienvenues !

  • Ouvrez une issue pour signaler des bugs ou demander des fonctionnalités
  • Soumettez une pull request
  • Partagez vos astuces de workflow multi-comptes

📄 Licence

MIT © 2026