Token Receipt: La herramienta que te muestra cuánto te cuesta realmente tu agente de código

Vamos a ser sinceros: cuando estás metido de lleno en una sesión de código con Claude Code, Codex o Cursor, los tokens son algo abstracto. No ves el dinero salir de tu cuenta en tiempo real. Pero llega el final de mes, abres la factura y ahí están las sorpresas.

Token Receipt le da la vuelta a esta experiencia. En lugar de esperar una cuenta al final, la recibes a mitad del sprint. Es un recibo, con ese estilo de ticket de papel térmico, que desglosa exactamente lo que tu agente de código ha estado haciendo en tus sesiones locales.

No se trata solo de los números

Lo interesante de Token Receipt es que no pretende ser otro dashboard de observabilidad. El desarrollador detrás de esto entendió algo importante: los developers compartimos capturas de pantalla. Tiramos mensajes de error en Slack, pegamos salidas de terminal en issues de GitHub, tomamos capturas de comportamientos raros para mostrárselas al equipo.

Un recibo que puedes capturar y compartir tiene otro peso distinto a una gráfica en un dashboard. Cuenta una historia: "Mira cuántas veces le hice releer el mismo archivo" o "Resulta que mi context window básicamente funciona como un animal de apoyo emocional".

¿Qué termina apareciendo en el recibo?

La herramienta analiza los logs de sesiones locales de cualquier agente que estés usando y extrae patrones. La versión 1 se enfoca en señales que pueden defenderse desde los logs mismos: cosas como lecturas repetidas de archivos, patrones de planificación antes de tocar código, turismo de herramientas MCP (sí, es una categoría real), y esas situaciones deliciosas de "subagente en modo middle management" donde tu agente crea ayudantes para coordinar ayudantes.

Las sesiones con mucho uso de cache y los runs costosos con poca producción también entran en la lista. Si alguna vez viste a un agente explorar metódicamente tu codebase, lograr un fix de tres líneas, y luego generar lo que se siente como una novela pequeña de output—esas sesiones tienen su propia línea en el recibo.

La filosofía local-first

Un punto que vale la pena destacar: Token Receipt no necesita otro API key. El path basado en skills usa tu sesión existente de Codex o Claude Code para hacer el formateo final. El runtime se queda local, lee tus logs de sesión y genera hechos estructurados. Sin telemetría, sin subir tus prompts o código en la v1.

Este enfoque importa para la confianza del desarrollador. Cuando estás usando una herramienta que analiza tus patrones de código, probablemente no quieres que esa información se vaya a otro lado. Token Receipt respeta ese límite por diseño.

Por qué Kiro CLI recibe tratamiento especial

El soporte para Kiro CLI es interesante porque usa el uso de créditos real en lugar de estimaciones basadas en tokens. El razonamiento es práctico: no todos los agentes exponen los mismos contadores. Entonces, en lugar de adivinar, Token Receipt lee lo que realmente está disponible y trabaja con esas señales. Si usas Kiro como parte de tu flujo diario, tu recibo va a reflejar esas sesiones junto con las de Codex y Claude Code.

El soporte para Cursor está marcado como experimental por razones similares—la actividad de herramientas y metadata del workspace son legibles, pero la contabilidad de gasto no es tan precisa como en los otros agentes. El trade-off está documentado claramente: los recibos de Cursor muestran comportamiento pero no costos exactos.

La propuesta de valor real

En su núcleo, Token Receipt es una herramienta de autoconciencia disfrazada de novedad divertida. Esos "malos hábitos" que expone—lecturas repetidas, context bloat, sobre-planificación—no son bugs. Son patrones que pueden indicar que tu flujo de trabajo podría optimizarse, o que tus prompts necesitan refinarse, o que necesitas un enfoque diferente para trabajar con tu agente.

El formato de captura de pantalla facilita compartir estos insights con los compañeros. Cuando todos se ríen de cuántas veces el agente releyó el archivo de configuración, también están teniendo implícitamente una conversación sobre cómo trabajar de manera más eficiente.

Cómo empezar

Si quieres ver cómo se ven realmente desglosadas las sesiones de tu agente, la instalación es directa a través del sistema de skills:

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

Luego solo llama a /token-receipt en tu próxima sesión. O sé específico: /token-receipt Generate a receipt for my last 30 days of usage si quieres el roast histórico completo.

El proyecto es MIT licensed y open source, así que si quieres extenderlo para otros agentes o personalizar el formato del recibo, el repositorio está disponible para contribuciones.

La línea de fondo

Token Receipt no te va a ahorrar dinero directamente—no está reduciendo tus costos de API. Pero podría cambiar cómo piensas sobre trabajar con agentes de código AI. Una vez que ves tus hábitos desglosados, es difícil volver a confiar ciegamente en el context window. A veces un recibo de papel térmico es exactamente la rendición de cuentas que no sabías que necesitabas.