# Cost Session

> Desglose de costo por mensaje dentro de una sola sesión. Es el complemento de detalle de cost-anomaly: cuando se marca una sesión como outlier, muestra qué mensajes concretos fueron caros.

Fuente: https://skillsagentes.com/skills/ruvnet/ruflo/cost-session
Markdown: https://skillsagentes.com/skills/ruvnet/ruflo/cost-session.md

Repositorio: https://github.com/ruvnet/ruflo
Autor: ruvnet
Licencia: MIT
Actualizado: hace 2 meses
Coste de contexto: 69 tok instalada, 787 tok al activarse, 787 tok con todos los archivos del bundle
Bundle: 1 archivo, 3 KB
Permisos que pide: bash

## 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-session --agent claude-code
# Cursor
npx -y skills add ruvnet/ruflo --skill cost-session --agent cursor
# Codex
npx -y skills add ruvnet/ruflo --skill cost-session --agent codex
# Gemini CLI
npx -y skills add ruvnet/ruflo --skill cost-session --agent gemini
# Windsurf
npx -y skills add ruvnet/ruflo --skill cost-session --agent windsurf
# Cline
npx -y skills add ruvnet/ruflo --skill cost-session --agent cline
```

## Qué hace

- Muestra el desglose de costo por mensaje dentro de una sola sesión, ordenado de mayor a menor.
- Calcula percentiles p50/p90/p99 del costo por mensaje y marca si el mensaje top es más de 2× el p99.
- Distingue el costo por escritura de caché del de tokens de salida, que puede ser el verdadero causante del gasto.

## Cuándo usarla

- Cuando `cost-anomaly` marca una sesión como outlier y hay que ver qué MENSAJES concretos fueron caros.

## Qué la activa

- "¿Qué mensajes de esta sesión fueron los más caros?"
- "Investiga por qué esta sesión salió tan cara"

## Antes de instalar

- Lee el jsonl de la sesión desde `~/.claude/projects/*/`.
- runs shell commands

## 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.

When cost-anomaly flags a session as a >3.5σ outlier, the next question
is "which MESSAGES were expensive?". cost-session answers that.

| Question | Skill |
|---|---|
| "Which sessions cost the most?" | `cost-conversation` |
| "Which sessions are outliers?" | `cost-anomaly` |
| **"Which messages in THIS session were expensive?"** | **`cost-session`** ← this |

## Algorithm

Implementation: [`scripts/session.mjs`](../../scripts/session.mjs).

1. Resolve session jsonl: `--session-id <id>` (scans `~/.claude/projects/*/`)
   or `--latest` (default; picks most-recently-modified jsonl).
2. Parse all assistant messages with `usage` blocks.
3. Cost each message via shared PRICING (`_prices.mjs`).
4. Sort descending by `cost_usd`, surface top-N (default 20).
5. Compute p50/p90/p99 of message costs for in-session percentile context.
6. Flag the top message if it's >2× the p99 — that's an in-session outlier.

## Why this matters: cache writes are the silent cost

Example real session, top message:
```
| # | Model    | In | Out | Cache W | Cache R | Cost      |
| 1 | opus-4-7 | 6  | 569 | 881898  | 0       | $16.58    |
```

Without the **Cache W** column it looks like "569 output tokens cost
$16" — that's wrong by 380×. The actual cost is ephemeral 1h cache
write at opus pricing: 881,898 tokens × $18.75/1M = $16.54.

Operators reading the table see immediately: "the model wrote 881K
tokens to ephemeral cache". From there the question becomes "why did
we cache 881K tokens of context for a 6-input request?" — that's a
real engineering signal.

## Drill-down workflow

```bash
# Step 1: find outliers across all sessions
cost anomaly --alert-on-outliers 1 || cost anomaly  # see which session-ids

# Step 2: drill into the flagged session
cost session --session-id <flagged-id> --top 10

# Step 3: open that jsonl at the timestamp the top message reports,
# inspect the prompt + tool calls
```

## Percentile context

Top of output:
```
| p50 (median) message | $0.85 |
| p90 message          | $1.45 |
| p99 message          | $1.74 |
```

Lets operators ask "is this top message a 2× outlier or a 380× one?"
without having to compute it themselves. The "top is >2× p99" footer
fires when the answer is "yes, this is an in-session outlier worth
investigating".

## --since filter

Useful for drilling into a specific time range within a long session:

```bash
cost session --since 2026-06-16T13:00:00Z --top 5
```

Only messages with `timestamp >= --since` are considered.

## Edge cases

- No costed assistant messages → "_No costed assistant messages_" + exit 0.
- `--session-id` not found in any project's jsonls → exit 2 with error.
- `--top` must be a positive integer → exit 2.

## 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)