Token Receipt: O Extrato que Ninguém Pediu, Mas Todos Precisam

Vamos combinar uma coisa: enquanto você está no meio de uma maratona de código com Claude Code, Codex ou Cursor, pensar em tokens parece algo abstrato. Não dá pra ver o saldo diminuindo em tempo real. Mas quando o mês termina... lá vem a fatura com aquele valor que você jura não reconhecer.

O Token Receipt muda completamente esse jogo. Em vez de esperar o prejuízo aparecer no cartão, você recebe um "recibo térmico" no meio do expediente. Sim, parece thosea impressão deShopping. E detalhadinho: mostra exatamente o que seu agente de codificação andou fazendo nas suas sessões locais.

Mais do que Números

O que me chamou atenção nesse projeto é que ele não tenta ser mais um dashboard de observabilidade. O desenvolvedor por trás dele entendeu algo que a gente sabe, mas raramente admite: a gente compartilha capturas de tela. Joga prints de erros no Slack, posta saídas do terminal em issues do GitHub, manda screenshot de comportamentos estranhos pro time.

Um recibo que você pode copiar e colar em qualquer lugar tem um peso diferente de um gráfico genérico num painel. Ele conta uma história. Tipo: "Olha quantas vezes eu fiz esse agente reler o mesmo arquivo" ou "Parece que meu context window é tipo um cachorro de emocional."

O Que Aparece Nessas Folhas

A ferramenta analiza seus logs de sessão locais e identifica padrões. A versão atual foca em sinais que dá pra defender direto dos dados—como leituras repetidas de arquivos, aquele padrão de "planeja antes de tocar", o chamado MCP tool tourism (sim, isso é uma categoria real), e aquelas situações engraçadas onde seu agente cria subagentes pra coordenar outros subagentes.

Sessões com muito cache e runs barulhentas com pouco output também entram na lista. Se você já ficou olhando um agente vasculhar seu código inteiro pra fazer uma correção de três linhas e depois cuspir um romance de saída—esses momentos ganham linha própria no extrado.

A Abordagem Local-First

Um ponto que merece destaque: Token Receipt não exige mais uma API key. O caminho mais direto usa suas sessões existentes de Codex ou Claude Code pra formatar o resultado final. O processamento fica na sua máquina, analisa seus logs e gera fatos estruturados. Sem telemetria, sem enviar seus prompts ou código pra lugar nenhum na versão 1.

Isso importa pra confiança do desenvolvedor. Quando você tá usando uma ferramenta que examina seus hábitos de codificação, provavelmente não quer que esses dados viagem pra algum servidor remoto. O Token Receipt respeita essa fronteira por design.

Por Que o Suporte ao Kiro CLI é Diferente

O suporte ao Kiro CLI é interessante porque usa dados reais de uso de créditos em vez de estimativas baseadas em tokens. A lógica é prática: nem todo agente expõe os mesmos contadores. Então em vez de chutar, o Token Receipt lê o que tá disponível e trabalha com esses sinais. Se você usa Kiro no dia a dia, seu recibo vai refletir essas sessões junto com Codex e Claude Code.

O suporte ao Cursor tá marcado como experimental pelas mesmas razões—atividade de ferramentas e metadados do workspace são legíveis, mas a contabilidade de gastos não é tão precisa quanto nos outros agentes. O trade-off tá documentado direitinho: receipts do Cursor mostram comportamento, mas não custos exatos.

O Verdadeiro Valor

No fundo, Token Receipt é uma ferramenta de autoconsciência vestida de curiosidade divertida. Aqueles "maus hábitos" que ele expõe—leituras repetidas, contexto inchado, superplanejamento—não são bugs. São padrões que talvez indiquem que seu fluxo pode ser otimizado, que seus prompts precisam de ajuste, ou que você precisa de uma abordagem diferente com seu agente.

O formato de screenshot facilita compartilhar essas percepções com o time. Quando todo mundo tá rindo de quantas vezes o agente releu o arquivo de configuração, vocês também estão, implicitamente, conversando sobre como trabalhar de forma mais eficiente.

Como Começar

Se quiser ver itemizado como suas sessões de agente realmente funcionam, a instalação é tranquila:

npx skills add ameyalambat128/token-receipt --skill token-receipt

Depois é só chamar /token-receipt na sua próxima sessão. Ou ser mais específico: /token-receipt Generate a receipt for my last 30 days of usage se quiser o roast completo do histórico.

O projeto é MIT e open source, então se quiser estender pra outros agentes ou personalizar a formatação do recibo, o repositório tá aberto pra contribuições.

Resumindo

Token Receipt não vai economizar dinheiro diretamente—ele não corta seus custos de API. Mas pode mudar como você pensa em trabalhar com agentes de codificação AI. Depois que você vê seus hábitos itemizados, fica difícil voltar a confiar cegamente no context window. Às vezes um recibo térmico é exatamente o tipo de responsabilização que você nem sabia que precisava.