OpenQuota

Resumo

O OpenQuota é um aplicativo open source e multiplataforma para acompanhar consumo, limites, horários de renovação e gastos de provedores de IA voltados a programação. O projeto declara suporte a OpenCode Go, além de outros provedores e planos.

Uso atual

Confirmado (evidência local, 2026-08-22): Yan usa o OpenQuota no Windows para acompanhar o OpenCode Go. O conector passou a reconhecer a sessão após a entrada de autenticação local ser identificada sob o nome de provedor esperado pelo aplicativo: opencode-go.

A alteração preservou a entrada anterior e foi precedida por backup. Esta nota não registra credenciais, caminhos de arquivos de autenticação nem identificadores de sessão.

Confirmado (evidência local, 2026-08-22): o consumo de OpenCode Go de Yan ocorre por chamadas do Hermes Agent, e não pelo cliente OpenCode. Uma ponte local consulta a fonte autenticada de uso e espelha seus percentuais e horários de reset no cálculo do OpenQuota; esse painel não é uma integração nativa e seus custos sintéticos não representam consumo financeiro.

Limitações e cuidados

• O OpenQuota não consulta diretamente a fonte de uso do OpenCode Go para as chamadas feitas pelo Hermes Agent. Por isso, não deve ser tratado como uma integração nativa com a API do serviço.
• O espelho local depende da execução contínua de um script autenticado. Falhas de agendamento, consulta ou gravação podem deixar o painel desatualizado.
• Os custos inseridos no histórico local são sintéticos e existem somente para que o cálculo interno do OpenQuota reproduza percentuais e reset recebidos da fonte de uso. Eles não são um registro financeiro nem devem orientar decisões de gasto.
• Credenciais utilizadas pelo script e pelos conectores permanecem fora do vault, em armazenamento local apropriado.

Decisão de integração e execução silenciosa (2026-08-23)

Confirmado (evidência local): foi adotada uma ponte de espelhamento para que o painel do OpenQuota acompanhe a cota do OpenCode Go usada pelos fluxos do Hermes Agent. Um script local autenticado consulta a fonte de uso e regrava entradas sintéticas, identificáveis e separadas do histórico real, para que o cálculo interno do OpenQuota exiba os percentuais e horários de reset recebidos.

Operação confirmada (evidência local, 2026-08-23): a injeção é executada a cada cinco minutos por uma tarefa do Agendador de Tarefas do Windows. Ela chama diretamente pythonw.exe, a variante sem console do Python, para evitar janelas de terminal e roubo de foco. Um disparo manual da tarefa retornou êxito (Last Result: 0).

Decisão operacional: a rotina duplicada do agendador do Hermes Agent foi removida. A tarefa do Windows é a única via periódica de injeção confirmada; isso evita concorrência e elimina a segunda janela que a duplicação produzia.

Defesa adicional: o script de injeção foi ajustado para solicitar a criação sem janela ao iniciar processos secundários no Windows. Essa salvaguarda reduz regressões caso seja acionado por outra automação.

Diagnóstico de pop-ups recorrentes (evidência local, 2026-08-23): ao investigar uma janela de terminal que reaparece em uma cadência de cinco minutos, não basta inspecionar a tarefa suspeita. Tarefas independentes podem compartilhar os mesmos limites de horário; o diagnóstico deve enumerar no Agendador todas as tarefas com intervalo de cinco minutos e verificar também os executáveis e wrappers que cada uma inicia. A correção requer execução sem console em toda a cadeia aplicável — por exemplo, pythonw.exe em vez de python.exe para scripts Python — e validação posterior de que o processo permanece funcional sem roubar o foco.

Cuidados: esta solução é uma adaptação local, não uma integração oficial do OpenQuota. O vínculo entre percentuais reais e custos artificiais depende de limites internos do aplicativo, portanto números monetários e projeções derivados dessas entradas não são confiáveis. O backup anterior e a identificação das entradas permitem reversão sem modificar o histórico genuíno.

Limitação técnica confirmada (evidência local): gravar diretamente o histórico local não atualiza, por si só, uma interface do OpenQuota já aberta, pois ela mantém estado em memória. A operação deve validar o painel após a atualização e tratar uma recarga ou recálculo pelo aplicativo como parte da recuperação; o conteúdo persistido em disco, sozinho, não comprova que a interface exibiu a cota nova.

Granularidade da quota Google AI Pro (2026-08-23)

Confirmado por evidência local registrada: a rota da assinatura Google AI Pro usada pelo adaptador local fornece ao OpenQuota apenas a visão agregada de quota por grupo. A fonte também oferece uma visão por modelo, mas ela não implica necessariamente limites separados: no estado observado, os modelos Claude e GPT-OSS de um mesmo grupo exibiam a mesma fração restante. Portanto, o OpenQuota não deve apresentar essa informação como cota exclusiva de Claude Opus, Sonnet ou GPT-OSS sem uma integração adicional e validação do backend.

Para monitorar a cota atual do adaptador, usar sua visão agregada; para diagnóstico por modelo, consultar a fonte do adaptador e tratar os valores como pertencentes ao grupo até haver evidência de buckets independentes. Não registrar snapshots de percentuais, resets, sessões ou identificadores de conta no vault.

Recuperação após atualização (2026-08-26)

Relatado em operação local: após uma tentativa de atualização automática para a versão 0.5.0, o Windows Defender teria removido o executável do OpenQuota sob a detecção heurística Trojan:Win32/Bearfoos.A!ml. A versão oficial foi então reinstalada a partir do repositório do projeto, e a inicialização automática do aplicativo foi reconfigurada.

Estado reportado: o aplicativo voltou a executar e sincronizou os provedores OpenRouter, Antigravity, Codex e OpenCode Go. Este registro não reproduz PID, caminhos de instalação, chaves do Registro, exclusões do Defender, credenciais ou identificadores de conta; tampouco substitui uma verificação local atual do processo e do painel.

Cuidado de segurança: uma detecção heurística/por aprendizado de máquina não demonstra, por si só, que um binário seja um falso positivo. Antes de restaurar ou excluir um executável das verificações do Defender, confirmar a origem oficial, a integridade e a versão do artefato; limitar qualquer exceção ao escopo estritamente necessário.

Telemetria de tokens do Gemini via proxy local (2026-08-28)

Confirmado por evidência local relatada: o OpenQuota acompanha quota e janelas de reset, mas não fornece, para a rota Google AI Pro observada, um histórico de tokens consumidos discriminado por modelo. Portanto, esse painel não deve ser usado como fonte de estatísticas de prompt, conclusão ou total de tokens do Gemini.

Uso operacional: o proxy local de IA registra cada chamada encaminhada com data/hora, nome do modelo, tokens de entrada, tokens de saída, total e latência. Esse log é a fonte apropriada para consolidações locais de consumo por modelo e por período; ele complementa o OpenQuota, em vez de substituir sua função de monitorar quota.

Cuidados: não registrar no vault os valores agregados de uso, caminhos locais do log, identificadores de sessão ou dados de requisição. Os números variam continuamente e podem expor padrões operacionais; a estatística deve ser gerada localmente quando necessária. A disponibilidade dos campos depende de as chamadas passarem pelo proxy e de o provedor retornar metadados de uso.

Relações no vault

• Hermes Agent — parte do consumo de IA de Yan ocorre por fluxos orquestrados fora do cliente OpenCode.

Fontes

• OpenQuota — repositório oficial, documentação e código-fonte do projeto, consultados em 2026-08-22. O README declara o objetivo do aplicativo e o suporte a OpenCode Go.
• Evidência local de configuração e uso do OpenCode Go, consultada em 2026-08-22. Não inclui credenciais, caminhos locais, identificadores de sessão ou números transitórios de cota.
• Evidência local: lote de captura consultado em 2026-08-23 (observação de quota por grupo e por modelo da rota AI Pro; comportamento sujeito a mudança).
• Evidência local relatada, consultada em 2026-08-28: o OpenQuota não expõe histórico de tokens por modelo para a rota Gemini observada; o proxy local registra metadados de uso por chamada. Sem credenciais, caminhos, identificadores ou métricas transitórias.