/ Directorio / Playground / Claude HUD
← Todos los servidores ↗ GitHub
● Comunidad jarrodwatts ⚡ Instantáneo

Claude HUD

por jarrodwatts · jarrodwatts/claude-hud

Un HUD en tiempo real para Claude Code — presupuesto de contexto, herramientas activas, subagentes en ejecución, progreso de tareas. Deja de volar a ciegas.

claude-hud es un plugin de Claude Code que muestra lo que realmente está ocurriendo durante una sesión: qué tan llena está la ventana de contexto, qué herramientas se están disparando, qué subagentes están activos, progreso de la lista de tareas. Orientado a devs que ejecutan sesiones largas o flujos de trabajo multi-agente donde '¿por qué esto se está volviendo lento?' se convierte en una pregunta real.

▶ Ver demo 📦 Instalar 💡 Casos de uso

Por qué usarlo

Características clave

Demo en vivo

Cómo se ve en la práctica

listo

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "claude-hud-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jarrodwatts/claude-hud",
        "~/.claude/plugins/claude-hud"
      ],
      "_inferred": true
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "claude-hud-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jarrodwatts/claude-hud",
        "~/.claude/plugins/claude-hud"
      ],
      "_inferred": true
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "claude-hud-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jarrodwatts/claude-hud",
        "~/.claude/plugins/claude-hud"
      ],
      "_inferred": true
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "claude-hud-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jarrodwatts/claude-hud",
        "~/.claude/plugins/claude-hud"
      ],
      "_inferred": true
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "claude-hud-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/jarrodwatts/claude-hud",
        "~/.claude/plugins/claude-hud"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json
{
  "context_servers": {
    "claude-hud-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/jarrodwatts/claude-hud",
          "~/.claude/plugins/claude-hud"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add claude-hud-skill -- git clone https://github.com/jarrodwatts/claude-hud ~/.claude/plugins/claude-hud

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: Claude HUD

Diagnosticar por qué una sesión larga de repente va lenta

👤 Devs que ejecutan sesiones de Claude Code de varias horas ⏱ ~10 min beginner

Cuándo usarlo: Las respuestas se sienten más lentas que al inicio; sospechas de presión de contexto.

Requisitos previos
  • Plugin instalado — Colócalo bajo ~/.claude/plugins o según la convención de plugins de Claude Code
Flujo
  1. Abrir HUD
    Abre el HUD. ¿Cuál es mi uso de contexto ahora mismo?✓ Copiado
    → Porcentaje en vivo con desglose
  2. Identificar los que consumen más
    ¿Qué llamadas a herramientas produjeron los resultados más grandes en los últimos 30 minutos?✓ Copiado
    → Lista top-N de outputs de herramientas grandes
  3. Compactar
    Compacta la conversación a un resumen. Verifica que el HUD muestra que el contexto bajó.✓ Copiado
    → La barra de contexto baja; la velocidad se recupera

Resultado: Sesiones que puedes ejecutar todo el día sin ralentizaciones inexplicables.

Errores comunes
  • La compactación agresiva pierde detalles importantes — Compacta selectivamente — mantén el último intercambio significativo

Hacer seguimiento de múltiples subagentes trabajando en paralelo

👤 Devs lanzando subagentes ⏱ ~15 min intermediate

Cuándo usarlo: Lanzaste 3 subagentes y perdiste la pista de quién hace qué.

Flujo
  1. Listar
    Muéstrame todos los subagentes activos y sus tareas actuales.✓ Copiado
    → Ficha por subagente
  2. Detallar
    Muestra las llamadas recientes a herramientas y el progreso de tareas del subagente 'tester'.✓ Copiado
    → Línea de tiempo por subagente

Resultado: Visibilidad en un setup multi-agente que de otra forma sería una caja negra.

Errores comunes
  • Demasiados subagentes — el propio HUD se satura — Filtra / colapsa los que no están activos
Combinar con: mcp-agent-mail

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

claude-hud-skill + mcp-agent-mail

Coordinar + monitorear setups multi-agente

Usa mail para coordinación, HUD para estado en vivo.✓ Copiado
claude-hud-skill + claude-best-practice-skill

Planes disciplinados + seguimiento en vivo

Planifica con best-practice, observa el progreso en el HUD.✓ Copiado

Herramientas

Lo que expone este MCP

HerramientaEntradasCuándo llamarCoste
show_context (ninguno) Siempre que sospeches de inflación free
tool_timeline since? Encontrar latencia / outputs grandes free
list_subagents (ninguno) Hacer seguimiento de ejecuciones multi-agente free
todo_status (ninguno) Puntos de control de sesión free

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API
N/A
Tokens por llamada
Mínimo — el HUD es telemetría de solo lectura
Monetario
Gratis
Consejo
El propio HUD es barato; úsalo para encontrar las cosas caras que recortar

Seguridad

Permisos, secretos, alcance

Ámbitos mínimos: Read access to Claude Code session state
Almacenamiento de credenciales: Ninguno
Salida de datos: Ninguno

Resolución de problemas

Errores comunes y soluciones

El HUD no muestra nada

Plugin no cargado; verifica la ruta de instalación y reinicia Claude Code

Los números de contexto no coinciden con la configuración

El HUD lee el estado real de la sesión; la discrepancia suele ser por los tokens reservados del sistema

Alternativas

Claude HUD vs otros

AlternativaCuándo usarlaContrapartida
cc-lensQuieres una ventana de dashboard separadaUX diferente; no está integrado
/context integrado de Claude CodeUna comprobación rápida es suficienteSin línea de tiempo, sin vista de subagentes

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills