Inicio rápido

Sin instalar nada: corre un comando y ve en TallyGraph lo que gastas en agentes de código.

TallyGraph lee el historial de uso que los agentes de código ya guardan en tu máquina (Claude Code, Codex, OpenCode y Pi), lo convierte en registros de tokens y costo, y manda solo esos números, más las versiones del CLI y de los runtimes, a tu workspace. No hay SDK que integrar ni proxy que mantener.

Un token de escritura y un comando. El dashboard se actualiza en cuanto llega el primer lote.

Requisitos

Node.js 22.13 o más nuevo. El CLI lee archivos SQLite locales con node:sqlite. Revísalo con node --version.
Una cuenta y un workspace de TallyGraph.
Haber usado en esta máquina al menos un agente compatible (ver fuentes).

Tres pasos

1. Crea un token de escritura

Entra a Conectores en la app y crea un token. Se muestra una sola vez. El comando de esa página ya lo trae puesto.

2. Corre el comando

terminal

npx --yes tallygraph collect --token tg_xxxxxxxx

Encuentra los agentes instalados, lee su historial sin modificarlo y sube el uso. La última línea dice qué pasó:

[tallygraph] delivered=1284 rejected=0 retained=0 status=ok

3. Déjalo corriendo (opcional)

Instálalo como servicio para que el uso nuevo llegue cada 15 minutos, desde que inicias sesión:

terminal

npx --yes tallygraph service install --token tg_xxxxxxxx

Revísalo con tallygraph service status y quítalo con tallygraph service uninstall.

Fuentes compatibles

El CLI busca en estas rutas por defecto. No escribe nada ahí.

Agente	Lee de	Cambiar ruta
Claude Code	`~/.claude/projects`	`--claude-dir`
Codex	`~/.codex/sessions`	`--codex-dir`
OpenCode	`~/.local/share/opencode/opencode.db`	`--db`
Pi	`~/.pi/agent/sessions`	`--pi-dir`
claude-tap	`~/.local/share/claude-tap/traces.sqlite3`	`--db`
Cursor, tokscale	un archivo exportado que tú pasas	`--file`

Problemas comunes

Ves	Qué significa	Qué hacer
No local sources found	No existe ninguna de las rutas por defecto.	Usa el agente al menos una vez, o pásale su carpeta con el flag de ruta.
Error de versión de Node	Node es anterior a 22.13.	Actualiza Node (nvm install 22, o tu gestor de paquetes).
auth failed (401/403)	El token está mal, revocado o vencido.	Crea otro token. Las filas siguen en el spool local y salen en la próxima corrida.
retries exhausted	La red o la API fallaron cinco veces.	Vuelve a correr el comando. No se perdió nada.
El dashboard sigue vacío	La subida todavía no llega.	Espera unos segundos y recarga. Revisa que la última línea diga status=ok.

¿Quieres ver qué se mandaría antes de mandar nada? Corre npx tallygraph read. Imprime los eventos como líneas JSON y no hace ninguna llamada de red.