Tokmeter

---

Por qué

Cada agente te factura por separado y te muestra solo su propia parte. Claude Code sabe lo que costó Claude Code. Codex sabe lo que costó Codex. Nada sabe lo que costó hoy, ni qué proyecto está quemando más silenciosamente, ni si el modelo al que cambiaste es realmente más barato para el trabajo que haces.

Tokmeter responde eso a partir de los datos que ya están en tu disco. Analiza los registros de sesión locales de cada agente, los valora contra un catálogo de modelos en vivo y mantiene un registro diario de solo añadidura para que el historial sobreviva incluso después de que los agentes roten sus propios registros.

npx @sriinnu/tokmeter --today

Cómo se ve

CLI — uso por proyecto, modelo y proveedor	Resumen — un boletín semanal

También hay una interfaz de terminal (tokmeter-tui), un panel web local, una línea de estado para Claude Code y un servidor MCP para que un agente pueda consultar su propio gasto.

Instalación

Requiere Node.js 18+. Leer archivos de sesión no necesita credenciales de proveedor; las consultas de precios obtienen un catálogo público, y --light las omite por completo.

# Try it without installing
npx @sriinnu/tokmeter --today

# Install the CLI, and the daemon/MCP server
npm install -g @sriinnu/tokmeter @sriinnu/tokmeter-mcp

Paquete	Contenido
@sriinnu/tokmeter	API principal, CLI e interfaz de terminal
@sriinnu/tokmeter-mcp	Servidor MCP, daemon, línea de estado e interfaz de terminal en vivo

packages/core, packages/cli y packages/tui son paquetes privados del espacio de trabajo incluidos en @sriinnu/tokmeter. packages/web es una aplicación privada separada del espacio de trabajo que se ejecuta desde el código fuente.

Claude Code y Codex son los objetivos principales de validación. Consulta compatibilidad de proveedores para los otros analizadores y sus límites conocidos.

CLI

tokmeter --today
tokmeter models --project my-app --json
tokmeter daily --week
tokmeter projects
tokmeter stats --month
tokmeter digest --period week
tokmeter pricing sonnet

Los filtros incluyen --project, --claude, --codex, --week, --month y --since YYYY-MM-DD --until YYYY-MM-DD. Usa --json para salida legible por máquina y --light para informes solo de tokens.

• Alias: fusiona nombres de visualización, etiqueta proyectos u ocúltalos de las listas.
• Copia de seguridad y restauración: instantáneas portátiles, vista previa de limpieza, restauración. La limpieza elimina archivos fuente; conserva la confirmación y los pasos de copia de seguridad.
• Referencia de CLI: cada comando con ejemplos.
• Cómo funcionan los números: qué significa cada categoría y dónde entran las estimaciones.

API de TypeScript

La exportación raíz proporciona la API principal. Los ayudantes de consulta convenientes usan la subruta /cli.

import { TokmeterCore } from "@sriinnu/tokmeter";
import { loadTokmeterSummary } from "@sriinnu/tokmeter/cli";

const core = new TokmeterCore();
await core.scan({ providers: ["codex", "claude-code"], today: true });
const models = core.getModelCosts();
const daily = core.getDailyBreakdown();

const summary = await loadTokmeterSummary({ week: true, light: true });

Reutiliza un escaneo principal al consultar varios desgloses. Consulta guía de integración, uso de la API principal y SKILL.md para instrucciones de integración orientadas a agentes.

Daemon, MCP y línea de estado

tokmeter-mcp daemon start
tokmeter-mcp daemon status
tokmeter-mcp serve             # MCP server over stdio
tokmeter-mcp statusline        # one statusline tick
tokmeter-mcp live              # live terminal UI

El daemon usa el puerto HTTP local 9877 para consultas y el puerto WebSocket 9876 para registro en vivo. La aplicación de macOS, la línea de estado y el servidor MCP consumen su estado compartido. Los comandos del daemon pertenecen a @sriinnu/tokmeter-mcp; instálalo para estas superficies.

Las herramientas MCP usan el prefijo tokmeter_ y cubren consultas de uso, comparaciones, pronósticos, exportación y operaciones confirmadas de limpieza/restauración. Consulta la referencia de MCP para nombres, configuración y exportaciones programáticas.

tokmeter-mcp editors enumera los objetivos del instalador. tokmeter-mcp install-mcp y tokmeter-mcp install-statusline escriben configuración del editor; inspecciona la configuración generada para tu editor. Consulta arquitectura para detalles de registro, autenticación, actualización, almacenamiento y ciclo de vida del daemon.

Interfaces de terminal y web

# After installing @sriinnu/tokmeter
tokmeter-tui

# Without a global install
npx -p @sriinnu/tokmeter tokmeter-tui

La interfaz de terminal admite vistas de resumen, modelo, diario y estadísticas. Consulta sus teclas y comandos.

Ejecuta el espacio de trabajo web desde una copia del código fuente:

bun install
bun run dev:web

Abre http://localhost:3000. Consulta configuración web y fuentes de datos.

Aplicación de macOS

Las compilaciones de lanzamiento apuntan a Apple silicon y macOS 14+. También se requiere Node.js 18+ con npx para el daemon local.

Instala @sriinnu/tokmeter-mcp, ejecuta tokmeter-mcp daemon start y luego abre TokmeterBar desde /Applications. Descarga la aplicación desde GitHub Releases.

La ventana emergente da igual prominencia a los tokens de hoy y al costo estimado de API, con modelos y proyectos debajo. Las tarjetas de gráfico al pasar el cursor muestran tokens y costos diarios exactos. Detalles de uso expande totales de por vida, tendencias y señales. Se pueden seleccionar seis temas: Terminal, Paper, Prism, Lagoon, Carbon y Glass. El Hub proporciona desgloses más grandes y configuración. Configuración → Abrir panel web inicia su servidor local bajo demanda; Detener panel web o salir de la aplicación lo detiene.

Consulta detalles de compilación y ejecución de macOS, verificaciones de primer uso y validación de ventana emergente. El rastreador de finalización registra las puertas restantes de máquina nueva, confiabilidad, actualización, contabilidad, accesibilidad y prueba.

El recorrido sintético documenta cómo se generaron las imágenes de ejemplo; no es una captura de un candidato local actual.

Licencia

AGPL-3.0-only. Consulta notas de licencia para saber qué significa eso si integras Tokmeter en otro producto.