Acabou a espera quando a cota do Codex esgotar: Hermes adiciona /usage reset

Para desenvolvedores que vivem no Codex, o momento mais frustrante não é uma resposta errada — é bater no limite de cota no meio de uma tarefa longa e ter que esperar ou trocar de ferramenta para continuar. O contexto já está construído, as chamadas de ferramentas já foram executadas, e agora você precisa interromper o fluxo para resgatar um reset em outro lugar.

O Hermes Agent acabou de fazer o merge da PR #64280, adicionando o comando /usage reset. Agora você pode resgatar créditos de reinicialização de cota do Codex diretamente no Hermes, sem abrir a CLI do Codex ou o site, e sem perder sua sessão.

Qual problema isso resolve

A OpenAI dá aos usuários do Codex com plano ChatGPT créditos de reinicialização de limite de taxa. Pense neles como recargas de emergência: quando você atinge o limite de 5 horas ou o limite semanal, gastar um crédito acumulado recarrega a cota inteira.

Até agora, resgatar esses créditos exigia um dos seguintes:

  • A CLI do Codex
  • O aplicativo de desktop do Codex
  • O painel web da OpenAI

Para desenvolvedores que usam o Hermes como ponto de entrada principal, isso significava uma troca de contexto extra. O /usage reset conecta o mesmo fluxo de resgate à ferramenta que você já está usando.

Uso principal: três passos para recarregar

1. Atualize o Hermes

hermes update

2. Confirme que a conta do ChatGPT está conectada

hermes auth

Você precisa de uma conta do plano ChatGPT que inclua acesso ao Codex.

3. Verifique o uso atual

/usage

Se você tiver resets acumulados, o Hermes mostrará algo como:

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

4. Reinicie a cota

/usage reset

Se uma das janelas de limite de taxa estiver totalmente esgotada, o Hermes resgatará um crédito acumulado e restaurará a cota completa de 5 horas + semanal.

hero

Reset forçado e as proteções

O comando é mais cuidadoso do que parece. Um único reset acumulado restaura a cota completa de 5 horas e a semanal, então usá-lo antes do tempo seria um desperdício.

Por isso, o Hermes se recusa a resgatar a menos que pelo menos uma janela de limite esteja totalmente esgotada, e informa quanto ainda resta na janela mais ocupada. Substitua com --force:

/usage reset --force

Resultados possíveis:

Resultado Significado
reset Resgate bem-sucedido, cota restaurada
nothing_to_reset Nenhuma janela estava totalmente esgotada, crédito não foi gasto
no_credit Nenhum reset acumulado disponível
already_redeemed Este crédito já foi resgatado (proteção de UUID idempotente)
reset_wrong_provider O provedor atual não é openai-codex

Por que isso importa para desenvolvedores

Dois tipos de interrupção doem mais ao programar:

  1. Interrupção do fluxo — você está mergulhado em uma refatoração complexa e o modelo para de responder.
  2. Interrupção do contexto — o Codex já leu o projeto, executou comandos e produziu arquivos intermediários; trocar de ferramenta significa reestabelecer todo esse estado.

O /usage reset mantém a ação de reset dentro da mesma interface de chat que você já está usando. É especialmente útil para:

  • Sessões longas de refatoração — a tarefa já está rodando há centenas de linhas quando bate no limite.
  • Análise de vários arquivos — o contexto do projeto já está carregado; trocar de ferramenta exigiria reexplicar a tarefa.
  • Tarefas de Cron ou em segundo plano — uma execução sem supervisão que atinge a cota pode falhar completamente; o comando de reset oferece um caminho de recuperação.
  • Loops apertados de depuração — chamadas frequentes ao Codex esgotam a cota mais rápido; resets manuais economizam muita espera.

Como funciona por baixo do capô

De acordo com a PR #64280, a implementação é limpa e segue a semântica oficial do cliente Codex:

  • Reutiliza o resolvedor de credenciais Codex de três camadas do Hermes.
  • Chama o endpoint /rate-limit-reset-credits/consume da OpenAI com uma chave de idempotência UUID, espelhando o cliente oficial do Codex.
  • Lida com diferenças de PathStyle (/wham vs /api/codex) e o cabeçalho ChatGPT-Account-Id.
  • Disponível tanto na CLI quanto no Gateway, então funciona no terminal e em plataformas de mensagens como Telegram ou Discord.
  • Novas chaves de i18n adicionadas em todos os 16 idiomas, e documentação atualizada em cli.md e no índice de mensagens.

A cobertura de testes também é sólida: testes unitários, testes de comando do gateway, testes de paridade de i18n, e um E2E com socket real contra um backend falso do Codex local, verificando a renderização da dica, o bloqueio de proteção, o resgate com --force, a chave de idempotência no fio e ambos os pontos de entrada da CLI.

Outra atualização diária da equipe “cavalo de trabalho”

Se você acompanha o log de commits do Hermes, sabe que este projeto recebe commits quase todos os dias. A PR #64280 foi mesclada há dois dias, enquanto o repositório já tinha commits de quatro, sete e dezenove horas atrás. O ritmo de manutenção da equipe da Nous Research é o tipo de cadência de “cavalo de trabalho” que faz o Hermes parecer confiavelmente vivo.

O /usage reset não é um recurso chamativo de manchete. É uma melhoria pequena e prática que resolve uma dor real para quem realmente usa o Hermes para trabalhar. Essas geralmente são as melhores atualizações.

Principais conclusões

  • O /usage reset permite que você resgate resets acumulados do Codex diretamente dentro do Hermes, sem pular para a CLI do Codex ou o site.
  • Execute hermes update, confirme hermes auth e use /usage reset quando necessário.
  • Por padrão, ele evita o desperdício de créditos; apenas janelas totalmente esgotadas acionam um reset. Use --force para substituir.
  • Os resultados incluem reset, nothing_to_reset, no_credit, already_redeemed e reset_wrong_provider.
  • Funciona tanto na CLI quanto no Gateway, então usuários de terminal e de plataformas de chat podem usar.

Referências: