Saltar a contenido

RaiSE HUD

Piensa en el HUD como un piloto de Fórmula 1 piensa en su dashboard. El dashboard no maneja el auto — el piloto lo hace. Pero sin el dashboard, el piloto va a ciegas: sin tiempos de vuelta, sin temperaturas de neumáticos, sin lecturas de combustible. El HUD te da esa misma conciencia situacional para el desarrollo de software agentic.

El problema que resuelve

Sin el HUD, entender qué está pasando en una sesión de RaiSE significa cambiar entre múltiples ventanas al mismo tiempo:

  • Jira para revisar el estado de la historia y la fase del pipeline
  • La terminal donde tu pareja de IA está trabajando
  • Git log para ver qué se commiteó y cuándo

El HUD colapsa todo esto en una sola vista en el terminal que se actualiza en tiempo real. Te mantiene en flujo en lugar de cambiar de contexto.

De dónde vienen los datos

El HUD lee exclusivamente de la base de datos SQLite local de tu proyecto (raise.db). Sin llamadas a la red. Sin dependencia de servidor. Todo lo que muestra ya está en tu máquina.

graph LR
    DB[(raise.db)] --> DM[HUDDataManager]
    DM --> APP[RaiseHUD App]
    APP --> M[Missions]
    APP --> S[Sessions]
    APP --> P[Pipeline]
    APP --> E[Events]
    APP --> I[Insights]

Cinco tabs, cada uno mostrando una porción diferente de la misma base de datos. El HUD nunca escribe — es una superficie de observación de solo lectura.

HUDDataManager consulta la base de datos en tres intervalos:

Intervalo Qué actualiza
Cada 3 s Nuevas señales y eventos
Cada 5 s Sesión activa, ejecuciones de pipeline
Cada 30 s Estado de misión, índice de sesiones, KPIs

Un requisito: estar en el directorio del proyecto

El HUD resuelve raise.db desde tu directorio de trabajo actual. Si lo lanzas desde fuera del proyecto, los panels aparecerán vacíos — no porque algo esté roto, sino porque está buscando en una base de datos diferente (o ninguna).

# Siempre haz esto primero:
cd tu-proyecto-raise
rai hud

Esta es la fuente de confusión más común para nuevos usuarios. Si tus panels están vacíos, revisa tu directorio de trabajo primero.

Lo que el HUD NO es

  • No es un panel de control. No puedes disparar acciones desde el HUD. Observa, no actúa.
  • No reemplaza a Jira. Refleja el estado de tu historia y pipeline — no lo gestiona.
  • No depende de la nube. El HUD funciona completamente sin conexión. Sin servidor, sin token.

Próximos pasos

  • Comenzar — instala RaiSE y ejecuta tu primera sesión
  • HUD Getting Started — lanza rai hud y navega sus tabs (S3491.2, próximamente)
  • Referencia de Tabs y KPIs — qué muestra cada tab y cómo actuar (S3491.3)
  • Arquitectura del HUD — HUDDataManager, panels, y el ciclo de polling (S3491.4)