No más esperas cuando se agota la cuota de Codex: Hermes añade /usage reset

Para los desarrolladores que viven en Codex, el momento más frustrante no es una respuesta incorrecta: es chocar contra el límite de cuota a mitad de una tarea larga y tener que esperar o cambiar de herramienta para seguir. El contexto ya está construido, las llamadas a herramientas ya se ejecutaron, y ahora debes interrumpir el flujo para canjear un reinicio en otro lugar.

Hermes Agent acaba de fusionar el PR #64280, añadiendo el comando /usage reset. Ahora puedes canjear los reinicios de límite de uso de Codex directamente desde Hermes, sin abrir la CLI de Codex ni el sitio web, y sin perder tu sesión.

Qué problema resuelve

OpenAI otorga a los usuarios de Codex con plan ChatGPT créditos de reinicio de límite de tasa. Piensa en ellos como recargas de emergencia: cuando alcanzas el límite de uso de 5 horas o el semanal, gastar un crédito acumulado recarga todo el cupo.

Hasta ahora, canjear esos créditos requería uno de estos:

  • La CLI de Codex
  • La aplicación de escritorio de Codex
  • El panel web de OpenAI

Para quienes usan Hermes como punto de entrada principal, eso significaba un cambio de contexto extra. /usage reset conecta el mismo flujo de canje en la herramienta que ya estás usando.

Uso principal: tres pasos para recargar

1. Actualiza Hermes

hermes update

2. Asegúrate de que tu cuenta de ChatGPT esté conectada

hermes auth

Necesitas una cuenta de plan ChatGPT que incluya acceso a Codex.

3. Consulta tu uso actual

/usage

Si tienes reinicios acumulados, Hermes ahora mostrará algo como:

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

4. Reinicia tu cuota

/usage reset

Si una de las ventanas de límite de tasa está completamente agotada, Hermes canjeará un crédito acumulado y restaurará el cupo completo de 5 horas más el semanal.

hero

Reinicio forzado y las protecciones

El comando es más cuidadoso de lo que parece. Un solo reinicio acumulado restaura el cupo completo de 5 horas y el semanal, así que usarlo antes de tiempo es un desperdicio.

Por eso Hermes se niega a canjear a menos que al menos una ventana de límite esté completamente agotada, y te indica cuánto le queda a la ventana más ocupada. Sobrescribe con --force:

/usage reset --force

Resultados posibles:

Resultado Significado
reset Canje exitoso, cuota restaurada
nothing_to_reset Ninguna ventana estaba completamente agotada, no se gastó el crédito
no_credit No hay reinicios acumulados disponibles
already_redeemed Este crédito ya fue canjeado (protección de UUID idempotente)
reset_wrong_provider El proveedor actual no es openai-codex

Por qué importa para los desarrolladores

Dos tipos de interrupciones duelen más al programar:

  1. Interrupción del flujo — estás metido en una refactorización compleja y el modelo deja de responder.
  2. Interrupción del contexto — Codex ya leyó el proyecto, ejecutó comandos y generó archivos intermedios; cambiar de herramienta significa reestablecer todo ese estado.

/usage reset mantiene la acción de reinicio dentro de la misma interfaz de chat que ya estás usando. Es especialmente útil para:

  • Sesiones largas de refactorización — la tarea lleva cientos de líneas y de pronto golpea el límite.
  • Análisis de varios archivos — el contexto del proyecto ya está cargado; cambiar de herramienta obligaría a reexplicar la tarea.
  • Tareas de Cron o en segundo plano — una ejecución desatendida que golpea la cuota puede fallar por completo; el comando de reinicio ofrece una vía de recuperación.
  • Bucles ajustados de depuración — las llamadas frecuentes a Codex agotan la cuota más rápido; los reinicios manuales ahorran mucha espera.

Cómo funciona internamente

Según el PR #64280, la implementación es limpia y sigue la semántica oficial del cliente de Codex:

  • Reutiliza el resolvedor de credenciales de Codex de tres niveles de Hermes.
  • Llama al endpoint /rate-limit-reset-credits/consume de OpenAI con una clave de idempotencia UUID, igual que el cliente oficial de Codex.
  • Maneja diferencias de PathStyle (/wham vs /api/codex) y el encabezado ChatGPT-Account-Id.
  • Disponible tanto en CLI como en Gateway, así que funciona desde la terminal y desde plataformas de mensajería como Telegram o Discord.
  • Se añadieron nuevas claves de i18n en los 16 idiomas, y la documentación se actualizó en cli.md y el índice de mensajería.

La cobertura de pruebas también es sólida: pruebas unitarias, pruebas de comandos del gateway, pruebas de paridad de i18n, y un E2E con socket real contra un backend falso de Codex local que verificó la renderización de la pista, el bloqueo de protección, el canje con --force, la clave de idempotencia en el cable y ambos puntos de entrada de la CLI.

Otra actualización diaria del equipo “caballo de trabajo”

Si sigues el registro de commits de Hermes, sabes que este proyecto se actualiza casi a diario. El PR #64280 se fusionó hace dos días, mientras el repositorio ya tenía commits de hace cuatro, siete y diecinueve horas. El ritmo de mantenimiento del equipo de Nous Research es el tipo de cadencia de “caballo de trabajo” que hace que Hermes se sienta confiablemente vivo.

/usage reset no es una función llamativa de titular. Es una mejora pequeña y práctica que resuelve un dolor real para quienes realmente usan Hermes para trabajar. Esas suelen ser las mejores actualizaciones.

Conclusiones clave

  • /usage reset te permite canjear reinicios acumulados de Codex directamente dentro de Hermes, sin saltar a la CLI de Codex ni al sitio web.
  • Ejecuta hermes update, confirma hermes auth y luego usa /usage reset cuando lo necesites.
  • Por defecto te protege de desperdiciar créditos; solo ventanas completamente agotadas activan el reinicio. Usa --force para sobrescribir.
  • Los resultados incluyen reset, nothing_to_reset, no_credit, already_redeemed y reset_wrong_provider.
  • Funciona en CLI y Gateway, así que tanto usuarios de terminal como de plataformas de chat pueden usarlo.

Referencias: