Context Gauge

El Context Gauge es una barra de ocupación fina en la barra de título de un tile de Claude Code. Responde a una pregunta de un vistazo: ¿qué tan cerca está este agente de quedarse sin contexto? Es la señal que de otra forma solo obtendrías a posteriori, cuando el agente compacta o trunca a mitad de una tarea.

Observa el gauge cuando un agente lleva rato en una tarea larga. A medida que sube de verde a ámbar y luego a rojo, sabes que es momento de cerrar el turno, iniciar una sesión nueva o entregarle el trabajo a un agente nuevo antes de que la presión de contexto fuerce un resultado degradado.

Qué puedes hacer con él

• Ver de un vistazo lo llena que está la ventana de contexto — la barra de ocupación y la etiqueta de porcentaje en la barra de título del tile.
• Detectar problemas temprano — la barra se vuelve ámbar al 70% y roja al 90%, así lo sabes antes de que el agente se golpee contra el muro.
• Leer las cifras exactas al pasar el cursor — el tooltip muestra el conteo de tokens y el tamaño de la ventana de contexto del modelo, por ejemplo Context ~42% · 84k of 200k tokens (claude-opus-4-7).
• Seguir Dynamic Workflows por separado — cuando un tile está corriendo un Dynamic Workflow de Claude Code, el tooltip añade una cifra agregada de workflow … tokens (y un marcador (active) mientras los subagentes siguen corriendo), rastreada por separado del porcentaje principal para no falsear lo llena que está la sesión principal.

Cómo usarlo

1. Lanza o abre un tile de agente Claude Code. El gauge aparece en su barra de título automáticamente — no necesitas activar nada.
2. Observa el color mientras el agente trabaja:

   Rango	Color
   < 70%	Verde
   70–89%	Ámbar
   ≥ 90%	Rojo

3. Pasa el cursor sobre el gauge para ver el conteo exacto de tokens y el modelo.
4. Cuando el gauge suba a ámbar o rojo, decide si cerrar el turno actual, iniciar una sesión nueva o mover el trabajo a un agente nuevo.

El gauge solo se renderiza en tiles donde el agente detectado es Claude Code y un agente ya fue detectado. No aparece para Codex, Amp, OpenCode ni una shell normal — esos CLIs no exponen un bloque de uso local y estructurado como sí lo hace Claude Code.

Casos de uso comunes

• "¿Este refactor largo está a punto de compactar?" — vigila el gauge; si está rojo, cierra el turno o inicia una sesión nueva antes de que la presión de contexto degradé el resultado.
• "¿Cuánto margen le queda al agente para la próxima instrucción?" — pasa el cursor para ver el porcentaje exacto y el conteo de tokens.
• "¿Aparece el consumo de los subagentes del workflow?" — pasa el cursor sobre el gauge en un tile que corre un Dynamic Workflow; la cifra de tokens del workflow aparece por separado del porcentaje principal.

Consejos y buenas prácticas

• Trata el ámbar como "cierra pronto" y el rojo como "decide ya". El agente seguirá trabajando más allá del rojo, pero la calidad puede degradarse a medida que sube la presión de contexto.
• El gauge se pausa mientras la ventana de MadoHub está en segundo plano y se refresca de inmediato al volver, así la lectura siempre es actual cuando la estás mirando.
• Si una petición falla transitoriamente (lo más común es que todavía no exista un archivo de sesión), el gauge sigue mostrando su última lectura conocida en lugar de quedarse en blanco — no te asustes por un fallo breve.
• Los subagentes del workflow corren en sus propios contextos, no en la ventana de la sesión principal, así que su consumo de tokens se rastrea por separado y deliberadamente no se incorpora al porcentaje principal.

Funciones relacionadas

• Fleet — ve el progreso del workflow (workflow · 3/5 agents) por fila junto al estado.
• Dynamic Workflows — la función de Claude Code cuyo consumo de tokens de subagentes muestra el tooltip.
• MadoAgent — lanza un agente nuevo cuando un tile se está quedando sin contexto.

Limitaciones

• Solo para Claude Code. El gauge no se renderiza para otros tipos de agente ni para shells normales.
• El porcentaje es una aproximación basada en el bloque de uso del mensaje de asistente más reciente, no un conteo en vivo a nivel de SO.
• Las cadenas de modelo no reconocidas recurren a una ventana de contexto de 200.000 tokens como valor conservador por defecto, así que el porcentaje para un modelo totalmente nuevo puede estar ligeramente desviado hasta que la tabla de MadoHub se actualice.