Contribuição open source · Rust · CLI · AI Tooling
ccusage/
Ferramenta de terminal em Rust para monitoramento e auditoria em tempo real de consumo de tokens e custos de agentes e modelos de inteligência artificial.
- 1 PR aceito
- +6,1k linhas adicionadas
- 19,4k estrelas no GitHub
- 22/10/2026 primeiro PR
O projeto
O ccusage é um utilitário de linha de comando de alto desempenho escrito em Rust, desenvolvido para calcular, consolidar e auditar custos e volumes de tokens consumidos por ferramentas de IA no terminal.
Ao interceptar históricos e registros locais de execuções de agentes de desenvolvimento, a ferramenta fornece relatórios diários e semanais de uso, auxiliando equipes de engenharia no controle orçamentário de consumo de grandes modelos de linguagem.
Como cada PR foi feito
-
Um problema por PR
Cada PR resolve uma coisa só, com a menor mudança possível. Isso simplifica a revisão, reduz o risco de efeito colateral e permite desfazer uma mudança sem levar outras junto.
-
O problema vira teste
As correções chegam com testes automatizados que cobrem o caso que falhava, para o problema não voltar sem que ninguém perceba.
-
Os critérios do próprio projeto
Formatação, análise estática e a suíte completa de testes rodam na integração contínua do projeto, e a mudança só entra depois da revisão do mantenedor.
-
Escrito para quem revisa
A descrição de cada PR explica o problema, a mudança e como ela foi testada, para o mantenedor decidir com segurança.
Cada PR, em linguagem de negócio
Clique em um PR para ver o problema, o que foi feito e o valor entregue. O link no fim de cada um leva à discussão técnica completa no GitHub.
-
#1948incorporado pelo mantenedor, com co-autoria, em 22/10/2026 Custo do Claude Opus 5.5 no Antigravity deixa de aparecer zerado Sessões do Claude Opus 5.5 no Antigravity apareciam com custo zero e aviso de modelo sem preço. O problema foi relatado na issue #1947, com uma correção de referência, e o mantenedor o resolveu no PR #1948, que credita Vinícius como co-autor.
- O problema
- O ccusage calcula o consumo de tokens e o custo de agentes de IA a partir dos registros locais de cada ferramenta. O Antigravity identifica o Claude Opus 5.5 por um código numérico interno (1402) que o ccusage não conhecia, então usava um nome provisório sem tabela de preços. Nos relatórios, essas sessões apareciam com custo de US$ 0,00 e a ferramenta emitia um aviso de modelo sem preço, escondendo o gasto real de quem usa esse modelo.
- O que foi feito
- A issue #1947 apontou a causa exata, o código 1402 sem mapeamento no leitor do Antigravity, e veio com uma correção de referência e testes numa branch do fork de Vinícius: mapear o código e o nome provisório para o Claude Opus 5.5, que o catálogo de preços da ferramenta já contém. O mantenedor incorporou a correção no PR #1948, com testes que conferem o mapeamento, o custo calculado e o carregamento de registros reais nos relatórios diários, semanais, mensais e por sessão, e creditou Vinícius como co-autor dos dois commits.
- Valor entregue
- Quem usa o Antigravity com o Claude Opus 5.5 passa a ver o custo real das sessões nos relatórios, sem avisos de modelo sem preço, e times que acompanham orçamento de IA deixam de subestimar o gasto com esse modelo.
Números atualizados em 13/11/2026.
O mesmo cuidado no seu sistema
Os mesmos hábitos destes PRs valem para backends que movimentam dinheiro: reproduzir o problema antes de corrigir, provar a correção com teste e não deixar dado sensível escapar.