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

“No tengo ni idea de si Claude esta trabajando o mirando al infinito.”

Si alguna vez has lanzado una tarea compleja con Claude Code, conoces la sensacion. El terminal se queda en silencio durante una operacion larga, y no hay forma de saber si el contexto esta a punto de agotarse, si el agente esta atrapado en un bucle o si esta pasando algo.

Un plugin de codigo abierto ataco este problema de frente. Despues de usarlo personalmente, queria compartir por que merece la pena instalarlo.

Que muestra Claude HUD

Claude HUD coloca una barra de estado estilo videojuego en la parte inferior del 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 ha consumido
• Herramientas activas - Que herramientas (Read, Edit, Bash, etc.) estan ejecutandose en ese momento
• Estado de subagentes - Seguimiento de los agentes hijos creados mediante llamadas Task (Opus 4.5, Sonnet, etc.)
• Progreso de tareas - Visualizacion del estado de la lista de tareas interna de Claude

Como funciona por dentro

Para los curiosos, aqui va un vistazo rapido a lo que ocurre 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 ofrecer feedback casi en tiempo real

Por que los desarrolladores estan entusiasmados

La respuesta de la comunidad ha sido fuerte, y la razon es directa: este plugin aborda un punto de dolor central del trabajo con agentes IA.

• Resuelve el problema de opacidad - Las tareas largas ya no te dejan adivinando si el agente esta atascado, en bucle o a punto de alcanzar el limite de contexto
• Instalacion en tres lineas - Sin configuracion compleja, solo instalar y listo
• Eficiencia en depuracion - En flujos de trabajo con multiples pasos, puedes ver inmediatamente donde fallo algo
• Feedback visual - La barra de estado estilo videojuego encaja de forma natural en la cultura del vibe-coding, haciendo el desarrollo asistido por IA mas interactivo

Un comentario popular en la comunidad lo resumio bien: “Por fin puedo saber si Claude esta trabajando o sonando despierto.”

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 con frecuencia, vale la pena probarlo. Trabajar sin la ansiedad del contexto - saber exactamente cuando una sesion podria agotarse - da mas tranquilidad de la que imaginas. Pero el valor real es mas simple: poder ver que esta haciendo Claude en cualquier momento cambia tu forma de trabajar con el.

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