// CASE_FILE > GLASSBOX

IA / Agéntica · Observabilidad2026

Glassbox

No puedes mejorar un agente que no puedes ver. Construí un observador local de solo lectura que convierte una transcripción de Claude Code en un informe de comportamiento de seis métricas.

6
Métricas de comportamiento
1
Informe autocontenido
0
Llamadas de red
github.com/HUMBLEF0OL/glassboxFEED//LIVE
$ npx glassbox --latest
[ok] transcript parsed
[ok] 6 metrics scored
network calls ........ 0
report ............... glassbox.html
status: OBSERVED
$

// 01 > CONTEXT

Glassbox lee una transcripción JSONL de Claude Code y genera un único informe HTML autocontenido con seis métricas de comportamiento, una línea de tiempo de la sesión y una tarjeta de salud del harness. No hace llamadas de red y nunca controla al agente.

// 02 > THE_PROBLEM

Las sesiones de agente son opacas: cuando una ejecución se descarrila, no hay un relato legible de lo que el agente hizo realmente o por qué.

La transcripción en bruto es un muro de JSONL. No había forma de ver si un agente buscó de más, declaró la victoria pronto, se saltó la verificación o entró en bucle, los patrones que separan una ejecución sana de una derrochadora.

Antes

Sesiones opacas · solo JSONL en bruto · sin señal de comportamiento

// 03 > APPROACH

Construí un observador de cero dependencias y solo lectura que puntúa seis comportamientos y genera un único informe HTML portátil, construido intencionadamente bajo su propio harness para ilustrar lo que mide.

Seis métricas de comportamiento

Ratio grep-vs-semántico, detección de victoria temprana, densidad de verificación, exceso de alcance, continuidad y detección de bucles.

Seguro por construcción

De solo lectura y sin conexión: descubre automáticamente la transcripción más reciente, censura secretos y nunca controla al agente.

Node.jsJavaScriptESM

// 04 > THE_RESULT

Una transcripción desordenada se convierte en un único informe HTML autocontenido que puntúa seis comportamientos, con cero llamadas de red y censura completa de secretos.

Antes

  • Sesiones difíciles de inspeccionar
  • Sin métricas de comportamiento
  • Lectura manual de transcripciones

Después

  • Tarjeta de 6 métricas + línea de tiempo
  • 0 llamadas de red, secretos censurados
  • Comparación de dos sesiones
Si no puedes medir cómo se comporta un agente, no puedes arreglarlo. Glassbox se mantiene de solo lectura y sin conexión, así que observar nunca cambia la ejecución.
AAmit RanaAutor y mantenedor, Glassbox

¿Tienes un problema similar?

Reservar una llamada de 20 min