Finie l’attente quand le quota Codex est épuisé : Hermes ajoute /usage reset

Pour les développeurs qui passent leurs journées dans Codex, le moment le plus frustrant n’est pas une mauvaise réponse : c’est de heurter le plafond de quota en plein milieu d’une tâche longue et d’avoir à attendre ou à changer d’outil pour continuer. Le contexte est déjà construit, les appels d’outils ont été exécutés, et il faut maintenant interrompre le flux pour aller utiliser un reset ailleurs.

Hermes Agent vient de fusionner la PR #64280, ajoutant la commande /usage reset. Désormais, vous pouvez utiliser vos crédits de réinitialisation de quota Codex directement dans Hermes, sans ouvrir la CLI Codex ni le site web, et sans perdre votre session.

Quel problème cela résout

OpenAI offre aux utilisateurs de Codex avec un plan ChatGPT des crédits de réinitialisation de limites de débit. Pensez-y comme à des recharges d’urgence : lorsque vous atteignez la limite des 5 heures ou la limite hebdomadaire, dépenser un crédit accumulé recharge l’intégralité du quota.

Jusqu’à présent, pour utiliser ces crédits, il fallait passer par :

  • La CLI Codex
  • L’application de bureau Codex
  • Le tableau de bord web OpenAI

Pour les développeurs qui utilisent Hermes comme point d’entrée principal, cela signifiait un changement de contexte supplémentaire. /usage reset intègre ce même flux de rédemption directement dans l’outil que vous utilisez déjà.

Utilisation principale : trois étapes pour recharger

1. Mettre à jour Hermes

hermes update

2. Vérifier que le compte ChatGPT est connecté

hermes auth

Vous avez besoin d’un plan ChatGPT incluant l’accès à Codex.

3. Vérifier la consommation actuelle

/usage

Si vous avez des réinitialisations accumulées, Hermes affichera quelque chose comme :

You have 2 resets banked - use /usage reset to activate

4. Réinitialiser le quota

/usage reset

Si l’une des fenêtres de limite de débit est entièrement épuisée, Hermes dépensera un crédit accumulé et restaurera le quota complet des 5 heures + hebdomadaire.

hero

Réinitialisation forcée et garde-fous

La commande est plus prudente qu’elle n’y paraît. Une seule réinitialisation accumulée restaure le quota complet des 5 heures et le quota hebdomadaire, donc l’utiliser trop tôt serait du gaspillage.

Hermes refuse donc de réinitialiser tant qu’aucune fenêtre n’est complètement épuisée, et vous indique ce qui reste dans la fenêtre la plus sollicitée. Remplacez ce comportement avec --force :

/usage reset --force

Résultats possibles :

Résultat Signification
reset Réussite de la réinitialisation, quota restauré
nothing_to_reset Aucune fenêtre entièrement épuisée, crédit non dépensé
no_credit Aucune réinitialisation accumulée disponible
already_redeemed Ce crédit a déjà été utilisé (UUID idempotent)
reset_wrong_provider Le fournisseur actuel n’est pas openai-codex

Pourquoi c’est important pour les développeurs

Deux types d’interruptions sont particulièrement pénibles pendant le développement :

  1. Interruption du flux — vous êtes plongé dans une refactorisation complexe et le modèle cesse de répondre.
  2. Interruption du contexte — Codex a déjà lu le projet, exécuté des commandes et produit des fichiers intermédiaires ; changer d’outil signifie rétablir tout cet état.

/usage reset garde l’action de réinitialisation dans la même interface de chat que vous utilisez déjà. C’est particulièrement utile pour :

  • Les longues sessions de refactorisation — la tâche a déjà produit des centaines de lignes avant de heurter le plafond.
  • L’analyse multi-fichiers — le contexte du projet est déjà chargé ; changer d’outil impliquerait de réexpliquer la tâche.
  • Les tâches Cron ou en arrière-plan — une exécution sans surveillance qui atteint le quota peut échouer complètement ; une commande de réinitialisation offre une voie de récupération.
  • Les boucles de débogage serrées — les appels fréquents à Codex épuisent le quota plus vite ; les réinitialisations manuelles évitent beaucoup d’attente.

Fonctionnement interne

Selon la PR #64280, l’implémentation est propre et suit la sémantique officielle du client Codex :

  • Réutilisation du résolveur d’identifiants Codex en trois niveaux d’Hermes.
  • Appel au point de terminaison OpenAI /rate-limit-reset-credits/consume avec une clé d’idempotence UUID, comme le client officiel Codex.
  • Gestion des différences de PathStyle (/wham vs /api/codex) et de l’en-tête ChatGPT-Account-Id.
  • Disponible à la fois en CLI et en Gateway, donc utilisable depuis le terminal et depuis les plateformes de messagerie comme Telegram ou Discord.
  • Nouvelles clés i18n ajoutées dans les 16 langues, et documentation mise à jour dans cli.md et l’index de messagerie.

La couverture de tests est également solide : tests unitaires, tests de commandes gateway, tests de parité i18n, et un test E2E avec socket réel contre un faux backend Codex local, vérifiant l’affichage de l’indice, le bloc de garde, la rédemption avec --force, la clé d’idempotence sur le fil et les deux points d’entrée CLI.

Une nouvelle mise à jour quotidienne de l’équipe « bourreau de travail »

Si vous suivez le journal des commits d’Hermes, vous savez que ce projet évolue presque chaque jour. La PR #64280 a été fusionnée il y a deux jours, alors que le dépôt avait déjà des commits datant de quatre, sept et dix-neuf heures. Le rythme de maintenance de l’équipe de Nous Research est ce type de cadence de « bourreau de travail » qui fait que Hermes reste vivant et fiable.

/usage reset n’est pas une fonctionnalité tape-à-l’œil. C’est une petite amélioration pratique qui résout un vrai point de douleur pour ceux qui utilisent réellement Hermes pour travailler. Ce sont souvent les meilleures mises à jour.

Points clés

  • /usage reset vous permet d’utiliser vos réinitialisations accumulées de Codex directement dans Hermes, sans passer par la CLI Codex ni le site web.
  • Exécutez hermes update, confirmez hermes auth, puis utilisez /usage reset si nécessaire.
  • Par défaut, cela évite de gaspiller les crédits ; seules les fenêtres entièrement épuisées déclenchent une réinitialisation. Utilisez --force pour outrepasser.
  • Les résultats incluent reset, nothing_to_reset, no_credit, already_redeemed et reset_wrong_provider.
  • Fonctionne à la fois en CLI et en Gateway, donc les utilisateurs de terminal et de plateformes de chat peuvent en profiter.

Références :