Sobre o projeto

CodeBurn é uma ferramenta gratuita, de código aberto e local-first que rastreia o uso de tokens e custos de codificação por IA em 41 ferramentas e agentes (Claude Code, Cursor, Codex, Gemini, Grok, e mais). Ela lê os arquivos de sessão que as ferramentas de IA já escrevem no disco — não é necessário proxy, chaves de API ou upload de dados. Os dados de preços são obtidos do LiteLLM e atualizados diariamente. Está disponível em várias superfícies: um dashboard de terminal (npx codeburn), um dashboard web local (codeburn web), um aplicativo de barra de menu para macOS, um aplicativo de bandeja para Windows e um aplicativo de desktop multiplataforma. Um recurso Capacity Dock exibe anéis de uso de provedor em tempo real na borda da tela. Principais capacidades incluem: - Visão geral: Resumos copiáveis de gastos com IA por ferramenta, modelo, projeto e dia, com suporte para intervalos de datas personalizados e histórico de vida útil. - Otimização: Analisa sessões e a configuração do Claude Code em busca de padrões de desperdício, como re-leitura de arquivos, baixas razões de leitura:edição, servidores MCP não utilizados, agentes/habilidades fantasmas e arquivos CLAUDE.md inchados. As descobertas são agrupadas por urgência e incluem estimativas de economia de tokens/dólares com correções prontas para colar. Uma flag --apply pode aplicar interativamente correções de classe de configuração, com registro completo e suporte a desfazer. Um recurso de relatório compara posteriormente as economias estimadas com os resultados reais da sessão. - Proteção: Instala hooks opcionais no Claude Code para monitorar o custo da sessão em tempo real, com limites suaves, limites rígidos, pontos de verificação e abridores de sessão para projetos sinalizados. - Comparação: Compara modelos em termos de taxa de sucesso em uma única tentativa, taxa de repetição, autocorreção, custo por chamada/edição, tokens de saída e taxa de acerto no cache. - Rendimento: Correlaciona sessões de IA com commits de git por carimbo de data/hora para categorizar gastos como produtivos, revertidos, abandonados ou ambíguos. - Compartilhamento de dispositivo: Combina totais de uso entre máquinas na mesma rede local via emparelhamento autorizado por PIN. A ferramenta requer Node.js 22.13+ e pelo menos uma ferramenta suportada com dados de sessão no disco. Pode ser instalada via npm, npx, bunx, pnpm ou Homebrew.