Claude HUD: el plugin que hizo observables a los agentes IA

“No tengo idea si Claude esta trabajando o viendo al techo.”

Si alguna vez corriste una tarea compleja con Claude Code, conoces la sensacion. La terminal se queda callada durante una operacion larga, y no hay forma de saber si el contexto esta por reventar, si el agente quedo atrapado en un loop o si esta pasando algo.

Un plugin open source le entro de frente a este problema. Despues de usarlo yo mismo, quiero compartir por que vale la pena instalarlo.

Que muestra Claude HUD

Claude HUD pone una barra de estado estilo videojuego en la parte de abajo de tu terminal. Rastrea cuatro cosas en tiempo real:

• Uso de contexto - Una barra de progreso visual con porcentaje que muestra cuanto de la ventana de contexto de la sesion se consumio
• Herramientas activas - Que herramientas (Read, Edit, Bash, etc.) estan corriendo en ese momento
• Estado de subagentes - Seguimiento de los agentes hijos creados con llamadas Task (Opus 4.5, Sonnet, etc.)
• Progreso de tareas - Visualizacion del avance de la lista de tareas interna de Claude

Como funciona por dentro

Para los curiosos, aca va un vistazo rapido a lo que pasa detras de la barra de estado.

Procesamiento de entrada stdin

Claude Code pasa el estado de sesion directamente como payload JSON. El plugin calcula la utilizacion del contexto sumando input_tokens, cache_creation_input_tokens y cache_read_input_tokens, y dividiendo entre context_window_size.

Analisis de transcripciones

Los logs de sesion se procesan como un flujo linea por linea. El plugin detecta bloques tool_use y los empareja con entradas tool_result para rastrear el estado de cada herramienta como running, completed o error.

Visualizacion de rutas de archivos

La visualizacion de rutas de archivos esta bien resuelta:

• Extrae file_path de las llamadas a Read, Write y Edit para mostrar en que archivo se esta trabajando
• Trunca automaticamente las rutas largas al formato .../filename.ts
• Se actualiza cada 300ms aproximadamente para dar feedback casi en tiempo real

Por que los desarrolladores estan tan emocionados

La respuesta de la comunidad fue fuerte, y la razon es clara: este plugin le pega justo al punto de dolor central de trabajar con agentes de IA.

• Resuelve el problema de opacidad - Las tareas largas ya no te dejan adivinando si el agente esta atorado, en loop o a punto de llegar al limite de contexto
• Instalacion en tres lineas - Sin configuracion complicada, nada mas instalar y jalar
• Eficiencia en debugging - En flujos de trabajo con multiples pasos, puedes ver de inmediato donde se trono algo
• Feedback visual - La barra de estado estilo videojuego encaja natural con la cultura del vibe-coding, haciendo el desarrollo con IA mas interactivo

Un comentario popular en la comunidad lo resumio bien: “Por fin puedo saber si Claude esta chambeando o echando la hueva.”

Instalacion

Se configura en tres comandos:

/plugin marketplace add jarrodwatts/claude-hud
/plugin install claude-hud
/claude-hud:setup

GitHub: jarrodwatts/claude-hud

Por que importa

Si usas Claude Code seguido, vale la pena probarlo. Trabajar sin la ansiedad del contexto - saber exactamente cuando una sesion se podria acabar - da mas tranquilidad de la que te imaginas. Pero el valor real es mas simple: poder ver que esta haciendo Claude en cualquier momento cambia como trabajas con el.

La observabilidad no es solo para servidores y pipelines. Los agentes de IA tambien la necesitan.