Repolode
junhoyeo

junhoyeo/tokscale

CLI e TUI em Rust que monitoram o uso de tokens e os custos estimados em vários agentes de programação com IA, com um placar público opcional.

Estrelas
5,720
Forks
465
Issues abertas
88
Último commit
há 14 horas

O que é?

O Tokscale lê os dados de sessão locais que agentes de programação com IA, como Claude Code, Codex CLI, Gemini CLI, Cursor, OpenCode e muitos outros, gravam em disco. Em seguida, agrega a quantidade de tokens e os custos estimados por dia, semana, mês, modelo, cliente, projeto e sessão. Os resultados podem ser consultados em um painel interativo no terminal com várias abas, em uma tabela simples ou exportados como JSON para scripts e outras ferramentas.

Os custos são calculados com base nos dados de preços do LiteLLM, com o OpenRouter como alternativa, e incluem suporte a preços por faixa e descontos para tokens em cache. Os usuários podem adicionar substituições de preços personalizadas para modelos ainda não cobertos pelas bases de dados upstream. A análise e a agregação são executadas em um núcleo nativo em Rust.

O projeto também inclui uma interface web com um gráfico no estilo de contribuições e uma camada social que permite enviar dados de uso para um placar e um perfil público.

Recursos principais

  • 01Interface interativa no terminal com visualizações de resumo, modelos, uso diário e por hora, sessões, projetos e agentes
  • 02Monitora o uso em dezenas de agentes de programação, incluindo Claude Code, Codex CLI, Gemini CLI, Cursor e OpenCode
  • 03Detalha tokens de entrada, saída, leitura e gravação de cache e raciocínio
  • 04Estima custos com os preços do LiteLLM, usando o OpenRouter como alternativa e permitindo substituições personalizadas
  • 05Filtra por cliente, período ou ano e exporta dados em JSON

Casos de uso

  • Conferir quanto você gasta por mês em vários agentes de programação com IA
  • Atribuir os custos de programação com IA a projetos ou espaços de trabalho específicos
  • Usar dados de uso em scripts ou painéis por meio da saída em JSON
  • Comparar modelos e clientes para descobrir onde os tokens estão sendo usados

Início rápido

  1. 1

    Envie seus dados de uso para o ranking com bunx

    bunx tokscale@latest submit

Antes de usar

  • Alguns clientes não têm dados de uso locais, então o uso de tokens do Freebuff é estimado com base nas transcrições.
  • Para consultar o uso do Cursor, é necessário fazer login automático no aplicativo para desktop ou colar um cookie. Os dados são lidos de uma cópia em cache da API.

Tópicos

Perguntas frequentes

O que é tokscale?
CLI e TUI em Rust que monitoram o uso de tokens e os custos estimados em vários agentes de programação com IA, com um placar público opcional. O Tokscale lê os dados de sessão locais que agentes de programação com IA, como Claude Code, Codex CLI, Gemini CLI, Cursor, OpenCode e muitos outros, gravam em disco. Em seguida, agrega a quantidade de tokens e os custos estimados por dia, semana, mês, modelo, cliente, projeto e sessão. Os resultados podem ser consultados em um painel interativo no terminal com várias abas, em uma tabela simples ou exportados como JSON para scripts e outras ferramentas.
tokscale é gratuito? Qual é a licença?
tokscale é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
tokscale ainda é mantido?
Manutenção ativa. O último commit de tokscale foi em 22 de out. de 2026.
Para que posso usar tokscale?
Conferir quanto você gasta por mês em vários agentes de programação com IA Atribuir os custos de programação com IA a projetos ou espaços de trabalho específicos Usar dados de uso em scripts ou painéis por meio da saída em JSON Comparar modelos e clientes para descobrir onde os tokens estão sendo usados
Como instalar tokscale?
Envie seus dados de uso para o ranking com bunx: bunx tokscale@latest submit
Onde consigo tokscale?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/junhoyeo/tokscale

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados