Tokentab calcula gasto com IA no terminal sem enviar dados para a nuvem

Por padrão, a ferramenta vasculha diretórios já existentes no computador: ~/.claude/projects//.jsonl para Claude Code, ~/.codex/sessions//rollout-.jsonl para Codex e ~/.gemini/tmp/*/session-.json para Gemini CLI. O repositório também inclui um esboço de conector para o Cursor, mas essa integração continua inacabada no código. Se um desses programas não estiver instalado na máquina, o leitor simplesmente pula o caminho ausente. Nada sai do disco local.

Leitura direta do disco dispensa banco e serviços externos

A arquitetura do projeto recorre quase que integralmente à biblioteca padrão do Python, mantendo o pacote rich como única dependência externa para desenhar tabelas coloridas no terminal. O programa extrai o volume exato de tokens lendo as contagens brutas que cada assistente anota por chamada. Para evitar cobrança duplicada, o código desconta tokens de cache antes de aplicar tarifas, já que o Gemini CLI reporta entradas com cache incluído e o Claude Code separa leituras e escritas. Os valores em dólares por milhão de tokens ficam salvos em uma tabela manual no arquivo tokentab/pricing/prices.py.

Essa tabela de preços adota busca aproximada para identificar variações de nomes, permitindo que a chave claude-opus-4-6-20260514 encontre o valor de claude-opus-4-6. Caso o modelo não conste na listagem, o terminal exibe $0.00 e alerta o usuário em vez de computar a chamada como gratuita. A categorização de tarefas entre código, depuração, refatoração ou testes ocorre de forma determinística: o algoritmo avalia as ferramentas acionadas e o texto da primeira mensagem, sem chamar modelos de linguagem. Cada integração nova exige apenas um módulo dentro de tokentab/providers/ com uma função collect() que devolve instâncias de UsageRecord.

Servidor embutido abre painel web na porta 4747

Para adotar o utilitário, basta clonar o repositório e instalar o pacote no ambiente de desenvolvimento local, o que disponibiliza o binário tokentab no path do sistema operacional, ou executar o script a partir do código-fonte. O comando básico exibe o consumo acumulado dos últimos sete dias e remove cores automaticamente ao enviar o resultado para pipes ou arquivos de texto. Ao iniciar o painel web nativo, a aplicação sobe um servidor HTTP local na porta http://localhost:4747, que lê o disco a cada requisição sem salvar dados em cache nem buscar fontes em CDNs externas. Quem prefere ajustar a exibição pode passar o parâmetro --port ou a flag --no-open para evitar a abertura automática do navegador.

Com último commit registrado em 3 de outubro de 2026 e apenas uma issue aberta, o projeto ainda tem maturidade inicial e depende da estabilidade dos formatos de log adotados pelos fornecedores. A licença MIT autoriza uso comercial, auditoria interna e alterações no código sem burocracia. A ferramenta não atende equipes que rodam agentes em contêineres efêmeros na nuvem sem persistência de disco ou empresas que exigem consolidar métricas de faturamento em tempo real por meio de webhooks corporativos.