Token Receipt: Când factura devine o glumă (serioasă)

Să fim onești: în timpul unei sesiuni de coding cu Claude Code, Codex sau Cursor, numărul de tokeni pare ceva abstract. Nu vezi banii evaporându-se în timp real. Dar la sfârșitul lunii, factura apare — și adesea te surprinde.

Token Receipt inversează experiența asta. În loc să aștepți nota de plată, primești una chiar în timpul sprint-ului. E un bon, stilizat ca o chitanță de la printer termic, care detaliază exact ce a făcut agentul tău de coding în sesiunile locale.

Nu e doar despre cifre

Ceea ce face Token Receipt interesant cu adevărat: nu încearcă să fie încă un dashboard de observabilitate. Dezvoltatorul din spatele lui a înțeles ceva important — dezvoltatorii share-uiesc screenshot-uri. Postăm mesaje de eroare în Slack, output din terminal în issue-uri GitHub și capturi de ecran cu comportamente ciudate pentru echipe.

Un bon pe care chiar îl poți screenshotui și trimite colegilor funcționează altfel decât un grafic dintr-un dashboard. Spune o poveste: „Uită-te de câte ori l-am pus pe agent să re Citească același fișier" sau „Se pare că fereastra mea de context e basically un animal de suport emoțional."

Ce ajunge efectiv pe bon

Tool-ul parsează log-urile sesiunilor locale de la orice agent folosești și extrage tipare. V1 se concentrează pe semnale care pot fi defendate din log-uri — lucruri precum citiri repetate de fișiere, tiparele de planning-înainte-de-touch, MCP tool tourism (da, e o categorie reală) și acele hilare situații de middle management în care agentul tău generează helperi ca să coordoneze alți helperi.

Sesiunile cu cache intensiv și run-urile scumpe cu output mic iau și ele loc pe bon. Dacă ai stat vreodată să vezi un agent explorând metodic codebase-ul tău, aplicând o corecție de trei linii, și apoi generând ce pare a fi un roman de output — acele sesiuni primesc propriul rând.

Filosofia Local-First

Ceva demn de evidențiat: Token Receipt nu necesită încă o cheie API. Path-ul skill-first folosește sesiunea ta existentă de Codex sau Claude Code pentru formatarea finală. Runtime-ul rămâne local, citește log-urile sesiunilor tale și generează fapte structurate. Fără telemetrie, fără upload-uri ale prompturilor sau codului în v1.

Această abordare contează pentru încrederea dezvoltatorilor. Când folosești un tool care îți analizează tiparele de coding, probabil nu vrei ca datele să zboare undeva în altă parte. Token Receipt respectă această graniță prin design.

De ce Kiro CLI primește tratament special

Suportul pentru Kiro CLI e interesant pentru că folosește creditele locale în loc de estimări derivate din tokeni. Raționamentul e practic: nu orice agent expune aceleași contoare. Așa că în loc să ghicească, Token Receipt citește ce e disponibil și lucrează cu acele semnale. Dacă folosești Kiro în workflow-ul tău zilnic, bonul tău va reflecta acele sesiuni alături de Codex și Claude Code.

Suportul pentru Cursor e marcat experimental din motive similare — activitatea tool-urilor și metadatele workspace-ului sunt lizibile, dar contabilizarea costurilor nu e la fel de precisă ca la ceilalți agenți. Trade-off-ul e documentat clar: bonurile Cursor arată comportament, nu costuri exacte.

Propunerea de valoare reală

La bază, Token Receipt e un tool de conștientizare de sine deghizat într-o noutate amuzantă. Acele „obiceiuri proaste" pe care le expune — citiri repetate, bloat de context, supra-planning — nu sunt bug-uri. Sunt tipare care ar putea indica că workflow-ul tău poate fi optimizat, că prompturile tale necesită refinare, sau că ai nevoie de o abordare diferită în colaborarea cu agentul tău.

Formatul de screenshot face ușor să partajezi aceste insights cu colegii. Când toată lumea râde despre câte ori agentul a recitit fișierul de config, implicit pornești o conversație despre cum să lucrați mai eficient.

Cum să începi

Dacă vrei să vezi cum arată sesiunile tale de agent itemizate, instalarea e straightforward prin sistemul de skills:

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

Apoi apelezi /token-receipt în următoarea sesiune. Sau fii specific: /token-receipt Generate a receipt for my last 30 days of usage dacă vrei roast-ul complet istoric.

Proiectul e licențiat MIT și open source, așa că dacă vrei să extinzi suportul pentru alți agenți sau să customizezi formatarea bonului, repository-ul e disponibil pentru contribuții.

Liniile de jos

Token Receipt nu te va salva direct la bani — nu reduce costurile tale API. Dar ar putea schimba cum gândești colaborarea cu agenții de coding AI. Odată ce îți vezi obiceiurile itemizate, e greu să te întorci la încrederea oarbă în fereastra de context. Uneori, un bon de hârtie termică e fix tipul de accountability pe care nu știai că îl ai nevoie.