Token Receipt: Когато твоят AI асистент ти издаде фискален бон

Да си признаем — когато си в разгара на coding сесия с Claude Code или Codex, токените са някаква абстрактна единица. Не гледаш как парите се изпаряват в реално време. Идва краят на месеца и сметката е пълна с изненади.

Token Receipt обръща цялата тази логика. Вместо да чакаш фактура, получаваш нещо като касов бон — точно по средата на спринта. Изглежда като разпечатка от термичен принтер и разбива на компоненти какво точно прави твоят coding agent в локалните сесии.

Повече от просто числа

Това, което прави Token Receipt наистина интересен, е че не се опитва да бъде поредната observability dashboard. Създателят му е разбрал нещо ключово — ние, програмистите, споделяме screenshot-и. Пускаме error съобщения в Slack, пъхаме terminal output в GitHub issues и снимаме странно поведение за екипите си.

Receipt, който можеш да снимаш и пратиш, действа съвсем различно от графика в някой dashboard. Разказва история: "Виж колко пъти накарах този agent да препрочита един и същи файл" или "Оказва се, че context window-ът ми е емоционална подкрепа".

Какво точно се появява в receipt-а

Инструментът парсва локалните session логове и извлича модели. V1 се фокусира върху неща, които могат да се докажат директно от логовете — като повтарящи се file reads, планиране преди действие, MCP tool tourism (да, това е истинска категория), както и онези забавни ситуации, в които твоят agent създава helpers, за да координират други helpers.

Сессии с тежко кеширане и скъпи операции с малко output също влизат в сметката. Ако си гледал agent да обикаля методично твоя код, да направи три реда промяна и после да генерира това, което изглежда като малък роман накрая — тези сесии си имат отделен ред.

Локалното е първо

Нещо важно: Token Receipt не изисква нов API ключ. Skill-first подходът използва твоята съществуваща Codex или Claude Code сесия за финалното форматиране. Runtime-ът остава локално, чете session логовете и генерира структурирани факти. Няма telemetry, няма изпращане на твоите prompts или код в първата версия.

Това има значение за доверието на разработчиците. Когато ползваш инструмент, който анализира твоите модели на работа, вероятно не искаш тези данни да летят някъде другаде. Token Receipt уважава тази граница по дизайн.

Защо Kiro CLI е специален случай

Поддръжката на Kiro CLI е интересна, защото използва локалното използване на кредити вместо token-based оценки. Причината е практична — не всеки agent показва едни и същи броячи. Затова вместо да гадае, Token Receipt чете това, което е налично, и работи с тези сигнали. Ако ползваш Kiro като част от ежедневния си workflow, твоят receipt ще отразява тези сесии заедно с тези от Codex и Claude Code.

Cursor поддръжката е маркирана като експериментална по сходни причини — tool activity и workspace metadata се четат, но точността на сметката не е като при другите агенти. Компромисите са документирани ясно: Cursor receipt-ите показват поведение, но не и точни разходи.

Истинското предимство

В основата си Token Receipt е инструмент за себеосъзнатост, облечен в забавна форма. Онези "лоши навици", които разкрива — повтарящи се прочитания, context bloat, прекалено планиране — не са бъгове. Това са модели, които може би показват, че твоят workflow може да се оптимизира, че prompts-ите ти се нуждаят от преработка, или че ти трябва различен подход към работата с агента.

Screenshot форматът прави споделянето на тези прозрения лесно. Когато всички се смеят колко пъти agent-ът е препрочел config файла, всъщност провеждат разговор за това как да работят по-ефективно.

Как да започнеш

Ако искаш да видиш как изглеждат твоите agent сесии разбити на редове, инсталацията е директна през skills системата:

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

След това просто извикай /token-receipt в следващата си сесия. Или бъди конкретен: /token-receipt Generate a receipt for my last 30 days of usage ако искаш пълната историческа критика.

Проектът е с MIT лиценз и е open source, така че ако искаш да го разшириш за други агенти или да персонализираш формата на receipt-а, repository-то е на разположение за принос.

Финални мисли

Token Receipt няма да ти спести пари директно — не намалява твоите API разходи. Но може да промени начина, по който мислиш за работата с AI coding agents. След като видиш своите навици разбити на редове, е трудно да се върнеш към сляпото доверие в context window-а. Понякога един receipt от термичен принтер е точно онази отчетност, за която не си знаел, че ти трябва.