Uma CLI que analisa o uso de tokens e os custos estimados de ferramentas de agentes de programação, como Claude Code e Codex, com base nos dados locais.
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
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
CLI local e app para desktop que detalham seus gastos com tokens de IA por ferramenta, modelo, projeto e tarefa.
Ferramenta local-first para navegar, pesquisar e acompanhar custos de tokens em agentes de programação com IA, como Claude Code e Codex.
Widget para desktop que acompanha uso de tokens, custos, limites e sessões em mais de 46 ferramentas de programação com IA, com sincronização opcional entre dispositivos.
Um agente de programação em TypeScript cuja CLI planeja, delega tarefas a vários modelos e verifica o trabalho quando você inclui `ulw` ou `mass ulw` no prompt.
Um harness com estado para criar agentes de IA com memória persistente, identidade e skills que evoluem com o tempo, acessíveis por CLI, navegador ou apps de chat.