Dashboard de observabilidad en tiempo real para sesiones de Claude Code. Monitoriza tokens, costos y actividad de todas tus sesiones con vista RPG gamificada.

13 de abril de 2026

● GitHub ● npm

// tech stack

TypeScriptSQLiteCommanderQR CodePixel Art

Real-timedashboard

Multi-sesiónmonitoring

QRacceso móvil

RPGvista gamificada

¿Por qué xray?

Cuando trabajas con Claude Code, cada sesión consume tokens sin que tengas visibilidad real de cuánto estás gastando. xray te da un dashboard visual en tiempo real donde ves todas tus sesiones activas, sus costos, tokens consumidos y actividad — incluso desde el móvil.

TipIncluye una vista RPG gamificada (Warriors) donde tus sesiones de Claude Code se representan como personajes en un campo de batalla, haciendo la observabilidad más visual y divertida.

Instalación

1. Instalar

npm install -g @cocaxcode/xray

2. Registrar hooks en Claude Code

cxc-xray setup

Registra 10 hooks en ~/.claude/settings.json: SessionStart, SessionEnd, PreToolUse, PostToolUse, PermissionRequest y más. Es idempotente y no destructivo — crea un backup antes de tocar nada.

3. Lanzar el dashboard

cxc-xray

Se abre automáticamente en el navegador en http://localhost:3333. Genera un QR para acceder desde el móvil con --expose.

DesinstalarPara eliminar los hooks limpiamente: cxc-xray uninstall

¿Qué puedes ver?

Sesiones activas

Ve todas tus sesiones de Claude Code en tiempo real: estado, tokens consumidos, herramientas en uso y proyecto actual.

Permisos desde el dashboard

Cada PermissionRequest aparece como burbuja ámbar. Aprueba o deniega con un click sin volver al terminal. Auto-approve para modo manos libres.

Tokens reales, no estimaciones

Lee directamente los archivos JSONL del transcript de Claude Code. Tracking incremental por byte offset — ves exactamente lo que Claude ve.

Vista Warriors (RPG)

Tus sesiones como guerreros pixel art. Sub-agentes como compañeros. MCPs como cristales orbitando. Goblins que crecen con el consumo de tokens.

Panel lateral con detalle

Click en cualquier sesión: historial paginado de eventos, resumen con tokens, archivos tocados, herramientas usadas y errores.

Acceso remoto con QR

Lanza con --expose, escanea el QR desde el móvil, introduce el PIN de 6 dígitos y aprueba permisos desde el sofá.

Comandos

Comando	Descripción
`cxc-xray`	Lanza el dashboard en puerto 3333 (auto-abre navegador)
`cxc-xray setup`	Registra hooks en Claude Code (idempotente)
`cxc-xray uninstall`	Elimina hooks de settings.json
`cxc-xray status`	Verifica si xray está corriendo, muestra sesiones y uptime
`cxc-xray pin`	Genera nuevo PIN de 6 dígitos para acceso remoto
`cxc-xray --expose`	Bind a 0.0.0.0 con QR + PIN para acceso LAN
`cxc-xray --port <n>`	Puerto custom (default 3333)
`cxc-xray --no-open`	No abrir navegador automáticamente

Así se ve en la práctica

Lanzar xray

$ cxc-xray

→ Dashboard abierto en http://localhost:3333
→ Detectadas 3 sesiones activas de Claude Code
→ 2 permisos pendientes

Vista Panel

Sesión 1: cocaxcode-api (Luchando)
  Tokens: 155k/16.2k | MCPs: engram
  3 tool calls activos

Sesión 2: cocaxcode-web (Luchando)
  Tokens: 26.5k/444.4k | MCPs: engram, Chrome, Preview
  12 tool calls activos

Acceso remoto

$ cxc-xray --expose

→ Dashboard en http://192.168.1.100:3333
→ QR generado — escanea desde tu móvil
→ PIN: 847291 (expira en 5 min)

100% localTodo corre en tu máquina. SQLite para datos, Fastify para el servidor, Vue para el dashboard. Sin cloud. Sin telemetría. Tus datos nunca salen de tu red.