Tokscale: Rastrear el uso de tokens de IA en múltiples plataformas – Herramienta CLI

En una era donde la codificación asistida por IA está por todas partes, tokens se han convertido en la nueva moneda de la productividad. Cada prompt que envías a Claude, Gemini, Codex o cualquier otro asistente impulsado por LLM consume caracteres, y esos caracteres cuestan dinero real. Los desarrolladores que no rastrean el uso, rápidamente se encuentran mirando facturas inesperadas.

Presentamos Tokscale – una utilidad de línea de comandos ligera y de código abierto que agrega automáticamente el uso de tokens de una amplia variedad de herramientas: OpenCode, Claude Code, Codex CLI, Gemini CLI, Cursor IDE, AmpCode, Factory Droid y OpenClaw. Con un solo comando, Tokscale extrae datos de tus carpetas de sesión local, consulta la base de datos de precios de LiteLLM y produce informes ordenados y visualizaciones bonitas.

✅ ¿Por qué Tokscale?

• 20+ seguidores en GitHub
• 508 ⭐
• 7 días+ de precios en tiempo real de LiteLLM
• UI de terminal interactiva (OpenTUI)
• Leaderboard y plataforma social
• Núcleo nativo en Rust (10× más rápido al procesar)
• Exportar a JSON para dashboards

Primeros pasos

Tokscale se distribuye a través de Bun – un entorno de ejecución JavaScript/TypeScript rápido que incluye un gestor de paquetes integrado. Si aún no usas Bun, instálalo rápidamente con:

curl -fsSL https://bun.sh/install | bash

1. Instalar Tokscale

bunx tokscale@latest

⚡ Tip: bunx ejecuta el paquete directamente sin añadirlo a tu proyecto – perfecto para uso puntual.

2. Ejecutar el TUI interactivo

tokscale

Te recibirás con un panel llamativo que incluye:

• Visión general: tokens totales, desglose de costos y una vista rápida de los modelos más usados.
• Modelos: costo y conteo de tokens por modelo.
• Diario: desglose día a día.
• Estadísticas: un gráfico de contribución estilo GitHub.

Usa el teclado (1–4 para cambiar pestañas, flechas para navegar) o el ratón (pestañas clickeables). Para una versión ligera e sin interacción, agrega la bandera --light:

tokscale --light

3. Filtrado y rangos de fechas

Tokscale brilla cuando quieres segmentar tus datos:

# Mostrar solo el uso de Claude Code de la última semana
tokscale --claude --week

# Restringir a un rango de fechas personalizado
tokscale --since 2024-01-01 --until 2024-12-31

# Combinar con salida de costos
tokscale models --month --github --json > monthly.json

La CLI acepta banderas cortas para cada fuente de datos (--opencode, --codex, --cursor, etc.), lo que facilita comparar una sola plataforma o una mezcla.

4. Búsqueda de precios en tiempo real

tokscale pricing "claude-3-5-sonnet"

Tokscale usa Litellm como su fuente principal y cae a OpenRouter para cualquier modelo nuevo o de nicho. La salida muestra el input, output y el precio de tokens cached en USD.

5. Funciones sociales – Leaderboard y Perfil

Tokscale no es solo una herramienta de estadísticas local. Incluye una plataforma basada en web que te permite:

• Iniciar sesión via GitHub OAuth.
• Enviar tus datos agregados a un leaderboard global.
• Explorar los perfiles de otros desarrolladores, comparar el uso de tokens y ver tendencias.
• Ver imágenes personalizadas de “Wrapped” que resumen el año.

tokscale login          # Abre el navegador para autenticación en GitHub
tokscale submit          # Envía datos al leaderboard
tokscale wrapped         # Genera la imagen inspirada en Spotify

Una vez en la plataforma, también puedes archivar datos antiguos o afinizar qué puntos de datos enviar.

Integración con CI/CD

El modo sin cabeza de Tokscale captura el uso de tokens de herramientas que generan JSON a stdout, ideal para pipelines de integración continua. Por ejemplo:

- name: Run AI check
  run: |
    mkdir -p ~/.config/tokscale/headless/codex
    codex exec --json "review code changes" > ~/.config/tokscale/headless/codex/pr-123.jsonl
- name: Collect usage
  run: tokscale --json > report.json

El archivo JSON puede alimentarse a dashboards de métricas o badges de CI.

Contribuir

Tokscale está abierto a contribuciones – ya sea que quieras añadir soporte para una nueva herramienta de IA, mejorar el núcleo en Rust o pulir la UI. El repositorio sigue flujos de trabajo estándar de GitHub:

1. Forkea el repo.
2. Crea una rama de características.
3. Ejecuta las pruebas (bun run test:all).
4. Envía una pull request.

La comunidad recibe con gusto informes de bugs y peticiones de funciones – simplemente abre un issue.

TL;DR

• ¿Qué? CLI para rastrear uso de tokens de muchos asistentes LLM.
• ¿Por qué? Tokens = costo; ve a dónde van en tiempo real.
• ¿Cómo? Instala con Bun, ejecuta tokscale, filtra o exporta.
• Más que CLI – Leaderboard, gráficos, integración CI.
• Código abierto – Licencia MIT, comunidad activa.

Reflexiones finales

Tokscale es más que una herramienta de métricas; es una forma de mantenerse consciente de los costos de IA mientras programas, y de comparar la productividad entre servicios. Con su backend nativo en Rust y TUI interactivo, se siente como una extensión de IDE de productividad en forma de terminal. Si estás en la frontera de la IA, prueba Tokscale y comparte tu uso en el leaderboard.