# Cost Track > Captura automáticamente el uso de tokens por sesión desde el jsonl de sesión de Claude Code y lo guarda en el namespace cost-tracking. Fuente: https://skillsagentes.com/skills/ruvnet/ruflo/cost-track Markdown: https://skillsagentes.com/skills/ruvnet/ruflo/cost-track.md Repositorio: https://github.com/ruvnet/ruflo Autor: ruvnet Licencia: MIT Actualizado: el mes pasado Coste de contexto: 29 tok instalada, 775 tok al activarse, 775 tok con todos los archivos del bundle Bundle: 1 archivo, 3 KB Permisos que pide: bash mcp__plugin_ruflo-core_ruflo__memory_store ## Instalación Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina. ```bash # Claude Code npx -y skills add ruvnet/ruflo --skill cost-track --agent claude-code # Cursor npx -y skills add ruvnet/ruflo --skill cost-track --agent cursor # Codex npx -y skills add ruvnet/ruflo --skill cost-track --agent codex # Gemini CLI npx -y skills add ruvnet/ruflo --skill cost-track --agent gemini # Windsurf npx -y skills add ruvnet/ruflo --skill cost-track --agent windsurf # Cline npx -y skills add ruvnet/ruflo --skill cost-track --agent cline ``` ## Qué hace - Lee el jsonl de la sesión activa de Claude Code, suma el uso por mensaje de cada modelo y calcula el costo en USD. - Escribe un registro estructurado en el namespace `cost-tracking`, que es la fuente de datos de `cost-report` y `cost-optimize`. - Permite fijar una sesión específica o hacer un dry-run sin escribir en memoria. ## Cuándo usarla - Después de un bloque significativo de trabajo, para capturar el gasto para el reporte. - Al final de la sesión, para persistir el total final. - Periódicamente durante sesiones largas, vía `/loop 30m`. ## Qué la activa - "Registra el gasto de esta sesión" - "Captura el uso de tokens actual en cost-tracking" ## Antes de instalar - Debe ejecutarse desde la raíz del proyecto para que localice automáticamente el jsonl de la sesión. ## Archivos - SKILL.md — 3 KB ## SKILL.md Reproducido tal cual desde ruvnet/ruflo bajo MIT. Esta sección es el documento original y está en inglés. # Cost Track Reads the active Claude Code session jsonl (`~/.claude/projects//.jsonl`), tallies assistant-message `usage` per model, computes USD cost using REFERENCE.md pricing, and writes a structured record to the `cost-tracking` AgentDB namespace. This is the **producer** that gives `cost-report` and `cost-optimize` real data to consume. ## When to use - After a meaningful chunk of work, to capture spend for the report. - At session-end to persist the final tally. - Periodically during long sessions (cron-friendly — see `/loop 30m`). ## Steps 1. **Run the tracker** from the project root: ```bash node plugins/ruflo-cost-tracker/scripts/track.mjs ``` The script auto-discovers the session jsonl from the current working directory. To pin a specific session: `TRACK_SESSION=/path/to/session.jsonl`. To dry-run (no memory write): `TRACK_DRY_RUN=1`. 2. **Inspect the markdown summary** — total cost, per-model and per-tier breakdowns, and the persisted memory key. 3. **Verify persistence** — `mcp__plugin_ruflo-core_ruflo__memory_search --query "session-" --namespace cost-tracking` should list the new record. `cost-report` step 1 reads from this namespace. ## Record shape (in `cost-tracking` namespace) Key: `session-`. Value (JSON): ```json { "sessionId": "1dba3b8c-...", "cwd": "/Users/cohen/Projects/ruflo", "startedAt": "2026-05-04T...", "endedAt": "2026-05-05T...", "messageCount": 234, "byModel": { "claude-opus-4-7": { "tier": "opus", "input_tokens": 12345, "output_tokens": 6789, "cache_creation_input_tokens": 800000, "cache_read_input_tokens": 2000000, "messages": 50, "cost_usd": 1.23 } }, "byTier": { "haiku": 0.0, "sonnet": 0.45, "opus": 1.23, "unknown": 0 }, "total_cost_usd": 1.68, "capturedAt": "2026-05-05T..." } ``` ## Pricing source of truth The script's `PRICING` constant mirrors REFERENCE.md "Model pricing (USD per 1M tokens)". Update both together when prices change. Cache-write tokens are billed at `cache_write` rate; cache-read tokens at `cache_read` (per Anthropic billing docs). ## Env overrides | Env | Default | Purpose | |---|---|---| | `TRACK_CWD` | `process.cwd()` | Override which project's sessions to scan | | `TRACK_SESSION` | most-recent jsonl | Pin a specific session file | | `TRACK_OUT` | unset | Also write the JSON summary to this path | | `TRACK_DRY_RUN=1` | unset | Skip the `memory store` call | | `TRACK_QUIET=1` | unset | Suppress markdown output | | `TRACK_NAMESPACE` | `cost-tracking` | Override target namespace | ## Cross-references - `cost-report` (consumer) — reads records produced by this skill - REFERENCE.md "Cost attribution formula" — the math the script implements - `cost-budget-check` (consumer; landing in P2) — reads totals to evaluate alerts ## Dónde encaja - Categoría: [Datos y analítica](https://skillsagentes.com/categorias/datos-analitica.md) — Consulta, limpia y visualiza datos sin salir del agente. - Creador: [ruvnet](https://skillsagentes.com/creators/ruvnet.md) — 275 skills en el directorio - [Todas las skills](https://skillsagentes.com/skills.md) - [Ranking de instalaciones](https://skillsagentes.com/ranking.md) ## Otras skills del mismo repositorio - [Harness Gepa](https://skillsagentes.com/skills/ruvnet/ruflo/harness-gepa.md): Inspecciona y audita genomas GEPA: carga y valida un genoma, renderiza el system prompt que compila, o clasifica los modos de fallo de una transcripción de ejecución. - [Deepseek Reason](https://skillsagentes.com/skills/ruvnet/ruflo/deepseek-reason.md): Completion en modo razonamiento contra deepseek-reasoner (R1) de DeepSeek. Devuelve el chain-of-thought por separado de la respuesta final. Lee DEEPSEEK_API_KEY y degrada si falta o la API no responde. - [Deepseek Chat](https://skillsagentes.com/skills/ruvnet/ruflo/deepseek-chat.md): Completion de un solo turno contra el modelo deepseek-chat de DeepSeek vía /v1/chat/completions. Lee DEEPSEEK_API_KEY y degrada con status:degraded si falta o la API no responde. Para tareas sin razonamiento. - [Adr Index](https://skillsagentes.com/skills/ruvnet/ruflo/adr-index.md): Construye o reconstruye el índice de ADRs y su grafo de dependencias ejecutando scripts/import.mjs, en vez de cientos de llamadas MCP. - [Agntcy Status](https://skillsagentes.com/skills/ruvnet/ruflo/agntcy-status.md): Muestra el estado de la integración AGNTCY/SLIM/CASA: si los paquetes están instalados, qué transporte está activo y si el enforcement de CASA está habilitado. --- Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)