Repolode
JingbiaoMei

JingbiaoMei/Tokdash

Panel local que registra el uso de tokens, los costos por sesión y los períodos de cuota de las suscripciones en agentes de programación con IA como Claude Code, Codex y OpenCode.

Estrellas
92
Forks
21
Issues abiertos
8
Último commit
hace 3 días

¿Qué es?

Tokdash es un panel local de tokens y costos para herramientas de programación con IA. Lee los registros de sesión que clientes como Claude Code, Codex, OpenCode y Gemini CLI guardan en tu equipo y muestra desgloses exactos de tokens de entrada, caché y salida, detalles de cada sesión y costos estimados.

Los mismos datos locales alimentan cuatro vistas: una WebUI servida con FastAPI, con mapas de calor e informes semanales, mensuales y anuales; un panel de terminal que se inicia con `tokdash tui`; una aplicación complementaria nativa para la barra de menús de macOS y el área de notificación de Windows; y un elemento de statusline que puede integrarse en la barra de indicaciones de un agente. Los costos se calculan a partir de una base de datos de precios incluida que puedes sobrescribir localmente.

El seguimiento de cuotas es opcional. Los períodos móviles de Codex se estiman a partir de los registros locales, mientras que los períodos de suscripción de otros proveedores requieren que habilites el sondeo en tiempo real, que utiliza la sesión iniciada que ya tiene tu CLI. Se instala mediante pipx y el comando `tokdash setup` registra un servicio local en segundo plano.

Funciones clave

  • 01Desgloses exactos de tokens de entrada, caché y salida por sesión, herramienta y modelo.
  • 02Mapa de calor de contribuciones e informes de uso semanales, mensuales o anuales exportables como PNG.
  • 03Pestaña de cuotas con barras de períodos de suscripción y cuentas regresivas hasta el restablecimiento para varios proveedores.
  • 04Panel de terminal con siete secciones, incluidas Overview, Sessions, Quota y Pricing.
  • 05Integración con statusline y aplicación complementaria nativa para macOS y Windows.
  • 06Permite combinar el uso de varias instancias de Tokdash que se ejecutan en distintos equipos.

Casos de uso

  • Consultar cuánto gastan cada día o mes los agentes de programación con IA de un equipo.
  • Comparar en una sola pantalla el uso de tokens de Claude Code, Codex y otros agentes.
  • Vigilar cuándo se restablecen las cuotas de suscripción sin abrir un navegador.
  • Conservar el historial local de los agentes aunque la configuración de retención del cliente lo elimine.

Inicio rápido

  1. 1

    Instala el paquete con pipx

    pipx install tokdash
  2. 2

    Ejecuta setup para registrar el servicio local y obtener la URL del panel

    tokdash setup

Antes de usarlo

  • El seguimiento de cuotas es opcional y requiere configuración adicional para cada proveedor.
  • Requiere Python 3.10 o posterior.

En colecciones

Temas

Preguntas frecuentes

¿Qué es Tokdash?
Panel local que registra el uso de tokens, los costos por sesión y los períodos de cuota de las suscripciones en agentes de programación con IA como Claude Code, Codex y OpenCode. Tokdash es un panel local de tokens y costos para herramientas de programación con IA. Lee los registros de sesión que clientes como Claude Code, Codex, OpenCode y Gemini CLI guardan en tu equipo y muestra desgloses exactos de tokens de entrada, caché y salida, detalles de cada sesión y costos estimados.
¿Tokdash es gratuito? ¿Qué licencia tiene?
Tokdash es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿Tokdash sigue mantenido?
Mantenimiento activo. El último commit de Tokdash fue el 3 nov 2026.
¿Para qué puedo usar Tokdash?
Consultar cuánto gastan cada día o mes los agentes de programación con IA de un equipo. Comparar en una sola pantalla el uso de tokens de Claude Code, Codex y otros agentes. Vigilar cuándo se restablecen las cuotas de suscripción sin abrir un navegador. Conservar el historial local de los agentes aunque la configuración de retención del cliente lo elimine.
¿Cómo se instala Tokdash?
Instala el paquete con pipx: pipx install tokdash Ejecuta setup para registrar el servicio local y obtener la URL del panel: tokdash setup
¿Dónde consigo Tokdash?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/JingbiaoMei/Tokdash

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados