Sobre o projeto

O Painel de Consumo de Tokens é uma ferramenta local de análise de uso voltada para usuários de agentes de IA. Ele lê diretamente os logs de sessão da máquina local, detecta automaticamente 12 fontes de logs, incluindo WorkBuddy, Claude Code, Codex, Cursor e Gemini CLI, e agrega o número de requisições, tokens de entrada/saída, acertos de cache, tokens de raciocínio e estimativas de custo, exibindo tudo em um painel HTML de arquivo único. A ferramenta funciona totalmente offline, não faz nenhuma requisição de rede e os dados não saem da máquina local. Ela depende apenas da biblioteca padrão do Python, sem necessidade de instalar pacotes adicionais via pip, e é compatível com Python 3.8 ou superior. Após a inicialização, um serviço HTTP local integrado é iniciado, a página é atualizada automaticamente a cada 15 segundos e também é possível gerar um snapshot estático para compartilhamento ou arquivamento. O painel inclui visões de visão geral, comparação entre fontes, distribuição por modelo, tendência diária e Top 20 de sessões, além de fornecer uma interface JSON em /api/data para facilitar a integração com scripts. A interface usa um esquema de cores roxo-ameixa e rosa-coral, com suporte a layout responsivo, modo escuro que acompanha o sistema e degradação de animações quando prefers-reduced-motion está ativo. A estimativa de custos é baseada em preços unitários públicos e permite substituir a tabela de preços por meio de um arquivo de configuração. A estrutura do projeto é clara: para adicionar um novo agente, basta adicionar uma configuração em sources.py. O parser adota uma estratégia de nomes de chave candidatos com descida recursiva, capaz de reconhecer automaticamente os nomes de campos de token mais comuns.