🌱 Empieza aquí · Token Insights

Esta semilla le da a tu asistente la capacidad de analizar cuánto gastas en Claude Code: cuánto llevas en tokens y en dólares, qué herramientas y skills usas más, dónde se te va el dinero y qué puedes optimizar. Es como pedirle un estado de resultados de tus propias sesiones de trabajo con inteligencia artificial.

Para instalarla

Abre esta carpeta con Claude Code o Cowork y dile a tu asistente:

"Siembra esta semilla 🌱"

Con eso basta de tu parte. Tu asistente hace todo lo técnico y al final te dice cómo comprobar que quedó funcionando. Vas a ver algunas palabras en inglés en la pantalla; ni caso, él te guía.

¿Otras formas de pedírselo? "instala esta semilla", "pon a funcionar el análisis de tokens", "haz el setup de esto". Te entiende igual.

Para el asistente que siembra 🤖

Esto es un skill (habilidad) de Claude Code que corre dos scripts de Python (solo librería estándar, cualquier Python 3.9+). No necesita hooks (ganchos de automatización) ni cambios en settings.json. No inventes rutas: usa $HOME siempre.

1. Copia el skill completo a la carpeta de skills del usuario

Copia toda la carpeta kernel/ como el skill get-token-insights:

Claude Code / Cowork (macOS o Linux):

DEST="$HOME/.claude/skills/get-token-insights"
mkdir -p "$DEST"
cp -R kernel/. "$DEST/"
chmod +x "$DEST/scripts/ingest_token_data.py" "$DEST/scripts/render_dashboard.py"

Windows (Git Bash / WSL): misma ruta ~/.claude/skills/get-token-insights/. Los scripts se invocan con python3 (o python), así que basta con tener Python instalado; el chmod es inofensivo si no aplica.

La estructura final debe quedar así:

$HOME/.claude/skills/get-token-insights/
├── SKILL.md
├── scripts/ingest_token_data.py
├── scripts/render_dashboard.py
├── scripts/tests/...
├── templates/dashboard.html
└── config/domains.json.ejemplo

2. (Opcional) Configura la agrupación por dominio

Si el usuario quiere ver su gasto agrupado por "áreas de trabajo" (por ejemplo Trabajo vs Personal), crea $HOME/.claude/token-insights/domains.json a partir del ejemplo config/domains.json.ejemplo, con la forma { "NombreDominio": ["palabra1", "palabra2"] }. Las palabras se buscan dentro de la ruta de cada proyecto. Sin este archivo, el desglose por dominio simplemente no aparece (no es un error).

3. (Opcional) Ajusta rutas con variables de entorno

Todo lo configurable se resuelve por variables de entorno, sin rutas personales embebidas. Los placeholders <TU-RUTA> de abajo se refieren a rutas de la máquina del usuario; por defecto no hacen falta porque todo vive dentro de $HOME/.claude/:

TOKEN_INSIGHTS_DB → <TU-RUTA> de la base de datos (default ~/.claude/token-insights/insights.db)
TOKEN_INSIGHTS_DASHBOARDS → <TU-RUTA> de salida del dashboard (default ~/.claude/token-insights/dashboards)
TOKEN_INSIGHTS_DOMAINS_FILE → <TU-ARCHIVO> de dominios (default ~/.claude/token-insights/domains.json)
TOKEN_INSIGHTS_HOOKS → nombres de hooks de sesión a verificar, separados por coma

4. Verificación post-siembra (obligatoria)

Paso A — la batería de tests debe pasar en verde:

cd "$HOME/.claude/skills/get-token-insights/scripts"
python3 -m unittest discover -s tests -p "test_*.py" 2>&1 | tail -3

Salida esperada (28 pruebas OK):

Ran 28 tests in 0.0XXs

OK

Paso B — la ingesta corre de verdad sobre los registros del usuario (modo --dry-run: no importa datos, solo crea la base vacía si no existe):

python3 "$HOME/.claude/skills/get-token-insights/scripts/ingest_token_data.py" --dry-run 2>&1 | tail -1

Salida esperada: una línea final parecida a esta, donde ambos números coinciden (los números varían según cuántas sesiones tenga el usuario; si es cuenta nueva pueden ser 0/0, y está bien):

[dry-run] N/N parsean OK

Cuando el Paso A dé OK y el Paso B corra sin error, avísale al usuario que ya quedó y explícale en una línea qué gana: ahora puede pedirte un reporte de su gasto en Claude Code cuando quiera.

Nota: la primera corrida real (sin --dry-run) puede tardar uno o dos minutos si el usuario tiene miles de sesiones acumuladas. Avísale antes. Las siguientes corridas son incrementales y toman segundos.

¿Cómo sé que funcionó?

Cuando esté instalado, dile a tu asistente algo como "analiza mis tokens", "¿cuánto llevo gastado en Claude Code?" o "dame un reporte de mi uso". Él correrá el análisis y te dará un resumen claro: tu gasto total, tus proyectos más caros, tus skills más usadas y un par de sugerencias concretas para ahorrar. Si le pides el dashboard, te genera una página web bonita y te la abre en el navegador.

Todo se calcula desde los registros que Claude Code ya guarda en tu propia computadora. Nada sale de tu equipo. 🌱