Token Receipt: quando il tuo AI coding assistant ti presenta il conto

Diciamolo chiaro: quando sei nel pieno di una sessione di coding con Claude Code, Codex o Cursor, i token sembrano un concetto astratto. Non vedi davvero i soldi uscire dal tuo account. Ma poi arriva la fattura di fine mese e ti ritrovi a fissarla chiedendoti cosa diavolo sia successo.

Token Receipt ribalta completamente questa esperienza. Invece di aspettare lo statement, te lo becchi a metà sprint. È uno scontrino — stile carta termica — che spacchetta quello che il tuo agente ha combinato nelle sessioni locali.

Non è solo una questione di numeri

Quello che rende Token Receipt davvero interessante è che non cerca di essere l'ennesima dashboard di osservabilità. Lo sviluppatore ha capito una cosa fondamentale: noi sviluppatori condividiamo screenshot. Incolliamo errori su Slack, postiamo output del terminale nelle issue GitHub, facciamo screenshot di comportamenti bizzarri per il team.

Uno scontrino che puoi catturare e condividere ha un impatto diverso da un grafico in una dashboard. Racconta una storia: "Guarda quante volte ho fatto rileggere lo stesso file a questo agente" oppure "A quanto pare il mio context window è sostanzialmente un animale di supporto emotivo."

Cosa finisce realmente sullo scontrino

Il tool analizza i log delle sessioni locali dall'agente che stai usando ed estrae i pattern. La versione 1 si concentra su segnali che sono difendibili partendo dai log stessi: ripetute letture di file, pattern di pianificazione-prima-di-toccare, turismo degli strumenti MCP (sì, è una categoria vera), e quelle deliziose situazioni di "middle management" dove il tuo agente genera helper per coordinare altri helper.

Anche le sessioni cache-intensive e le esecuzioni costose con output scarso vengono incluse. Se hai mai guardato un agente esplorare metodicamente il tuo codebase, completare una modifica di tre righe, e poi generare quello che sembra un piccolo romanzo di output — quelle sessioni hanno la loro voce dedicata.

La filosofia Local-First

Un aspetto da sottolineare: Token Receipt non richiede l'ennesima API key. Il percorso skill-first usa la tua sessione Codex o Claude Code esistente per la formattazione finale. Il runtime resta locale, legge i tuoi log di sessione e genera fatti strutturati. Niente telemetria, niente upload dei tuoi prompt o del codice nella v1.

Questo approccio conta per la fiducia degli sviluppatori. Quando usi un tool che analizza i tuoi pattern di coding, probabilmente non vuoi che quei dati volino da qualche altra parte. Token Receipt rispetta questo confine per design.

Perché Kiro CLI Ha Un Trattamento Speciale

Il supporto per Kiro CLI è interessante perché usa il credito locale invece di stime derivate dai token. Il ragionamento è pratico: non tutti gli agenti espongono gli stessi contatori. Quindi invece di indovinare, Token Receipt legge quello che è effettivamente disponibile e lavora con quei segnali. Se usi Kiro nel tuo workflow quotidiano, il tuo scontrino rifletterà quelle sessioni accanto a Codex e Claude Code.

Il supporto per Cursor è marcato come sperimentale per ragioni simili: l'attività degli strumenti e i metadati del workspace sono leggibili, ma la contabilizzazione della spesa non è precisa come per gli altri agenti. Il trade-off è documentato chiaramente: gli scontrini Cursor mostrano il comportamento ma non i costi esatti.

Il Valore Reale

Alla fine, Token Receipt è uno strumento di autoconsapevolezza travestito da novità divertente. Quei "cattivi abitudini" che espone — letture ripetute, context bloat, over-planning — non sono bug. Sono pattern che potrebbero indicare che il tuo workflow potrebbe essere ottimizzato, o che i tuoi prompt hanno bisogno di rifinitura, o che ti serve un approccio diverso per lavorare con il tuo agente.

Il formato screenshot rende facile condividere questi insight con i compagni di team. Quando tutti ridono sul quante volte l'agente ha riletto il file di configurazione, implicitamente state anche avendo una conversazione su come lavorare in modo più efficiente.

Come Iniziare

Se vuoi vedere come appaiono effettivamente spacchettate le tue sessioni con l'agente, l'installazione è diretta attraverso il sistema delle skills:

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

Poi basta chiamare /token-receipt nella tua prossima sessione. O essere specifici: /token-receipt Generate a receipt for my last 30 days of usage se vuoi la full roast storica.

Il progetto è licensed MIT e open source, quindi se vuoi estenderlo per altri agenti o personalizzare la formattazione dello scontrino, il repository è disponibile per contribuzioni.

Il Punto Della Questione

Token Receipt non ti farà risparmiare soldi direttamente — non sta tagliando i tuoi costi API. Ma potrebbe cambiare il modo in cui pensi al lavoro con gli agenti di coding AI. Una volta che vedi le tue abitudini spacchettate, è difficile tornare a fidarti ciecamente del context window. A volte uno scontrino su carta termica è esattamente la responsabilità che non sapevi di necessitare.