Token Receipt : quand votre agent IA vous envoie la note

Avouons-le : en pleine session de code avec Claude Code, Codex ou Cursor, les compteurs de tokens, c'est abstrait. On ne voit pas les dollars s'évaporer en temps réel. Mais à la fin du mois, la facture tombe — et elle est pleine de surprises.

Token Receipt inverse la donne. Au lieu d'attendre le relevé, vous le recevez en plein milieu du sprint. C'est un reçu, stylisé comme un ticket de caisse thermique, qui détaille ce que votre agent de coding a réellement fait pendant vos sessions locales.

Pas qu'une question de chiffres

Ce qui rend Token Receipt vraiment intéressant : ce n'est pas un énième dashboard d'observabilité. Le développeur derrière le projet a compris quelque chose d'essentiel — les devs partagent des captures d'écran. On balance des messages d'erreur sur Slack, on poste des sorties de terminal dans les issues GitHub, on screenshot des comportements inhabituels pour son équipe.

Un reçu qu'on peut vraiment screenshoter et partager, ça frappe différemment d'un graphique dans un dashboard. Ça raconte une histoire : « Regarde combien de fois j'ai fait relire le même fichier à mon agent » ou « Finalement ma fenêtre de contexte sert surtout de animal de compagnie émotionnel. »

Ce qu'on retrouve vraiment sur le reçu

L'outil parse les logs de sessions locales de l'agent que vous utilisez et extrait des patterns. La v1 se concentre sur des signaux extractibles directement des logs — comme les lectures de fichiers répétées, les patterns de réflexion avant action, le tourisme d'outils MCP (oui, c'est une vraie catégorie), et ces charmantes situations de middle management où votre agent engendre des helpers pour coordonner d'autres helpers.

Les sessions riches en cache et les runs chers avec peu de résultats font aussi partie du lot. Si vous avez déjà regardé un agent explorer méthodiquement votre codebase, accomplir une correction de trois lignes, puis générer ce qui ressemble à un petit roman en sortie — ces sessions ont leur propre ligne.

La philosophie local-first

Un point à souligner : Token Receipt ne demande pas un énième clé API. Le chemin skill-first utilise votre session Codex ou Claude Code existante pour le formatage final. Le runtime reste local, lit vos logs de session, et génère des faits structurés. Pas de télémétrie, pas d'upload de vos prompts ou de votre code en v1.

Cette approche compte pour la confiance des développeurs. Quand vous utilisez un outil qui analyse vos habitudes de coding, vous ne voulez probablement pas que ces données s'envolent ailleurs. Token Receipt respecte cette frontière par conception.

Pourquoi Kiro CLI a un traitement spécial

Le support de Kiro CLI est intéressant parce qu'il utilise l'utilisation de crédits locale au lieu d'estimations dérivées des tokens. Le raisonnement est pragmatique : tous les agents n'exposent pas les mêmes compteurs. Au lieu de deviner, Token Receipt lit ce qui est réellement disponible et travaille avec ces signaux. Si vous utilisez Kiro dans votre workflow quotidien, votre reçu reflètera ces sessions aux côtés de Codex et Claude Code.

Le support de Cursor est marqué expérimental pour des raisons similaires — l'activité des outils et les métadonnées du workspace sont lisibles, mais la comptabilité des coûts n'est pas aussi précise que pour les autres agents. Le compromis est documenté clairement : les reçus Cursor montrent le comportement mais pas les coûts exacts.

La vraie proposition de valeur

Au fond, Token Receipt est un outil d'auto-awareness déguisé en gadget fun. Ces « mauvaises habitudes » qu'il expose — lectures répétées, contexte bloated, sur-planification — ce ne sont pas des bugs. Ce sont des patterns qui peuvent indiquer que votre workflow pourrait être optimisé, que vos prompts méritent un polish, ou que vous avez besoin d'une approche différente avec votre agent.

Le format screenshot facilite le partage de ces insights avec l'équipe. Quand tout le monde rigole du nombre de fois où l'agent a relu le fichier de config, vous avez implicitement une conversation sur comment bosser plus efficacement.

Pour démarrer

Si vous voulez voir ce que vos sessions d'agent produisent en version itemisée, l'installation est simple via le système de skills :

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

Ensuite, appelez juste /token-receipt dans votre prochaine session. Ou soyez précis : /token-receipt Generate a receipt for my last 30 days of usage si vous voulez le roast complet de l'historique.

Le projet est sous licence MIT et open source, donc si vous voulez l'étendre à d'autres agents ou personnaliser le formatage du reçu, le dépôt est disponible pour contribution.

En résumé

Token Receipt ne vous fera pas économiser d'argent directement — il ne réduit pas vos coûts API. Mais ça pourrait changer votre façon de bosser avec les agents de coding IA. Une fois que vous avez vu vos habitudes itemisées, c'est dur de retourner à une confiance aveugle dans la fenêtre de contexte. Parfois, un ticket de caisse thermique, c'est exactement la redevabilité qu'on ne savait pas qu'on avait besoin.