Context Bar: barra de ventana de contexto de Claude Code por categorías

Context Bar es una barra de ventana de contexto de Claude Code, un mod de la comunidad creado por Hamza Zafar (hamzafer), parte de su colección claude-code-mods. Responde a una sola pregunta: ¿qué está llenando mi ventana de contexto? Sobre el prompt de Claude Code dibuja una pequeña franja con borde que contiene una única barra apilada del ancho de la terminal. La barra se divide en las mismas categorías que usa /context, como el prompt del sistema, las herramientas, las herramientas MCP, los archivos de memoria, las skills y los mensajes, seguidas del espacio libre y del búfer de autocompactación.

La línea de cabecera dice algo como 48k of 200k · compacts at 167k, con una insignia de porcentaje en color. La insignia es verde, pasa a amarillo al 70% del punto de compactación y a rojo al 90% (medido contra la ventana completa cuando la autocompactación está desactivada). Bajo la barra, una leyenda enumera cada categoría con su número de tokens y su porcentaje de la ventana, repartida en tantas líneas como requiera el ancho de la terminal. Los esquemas de herramientas que se cargan bajo demanda quedan fuera, igual que /context los deja fuera de su cuadrícula.

Context Bar se parece a nuestro propio Context Meter, pero muestran cosas distintas. Context Meter es una sola cadena en la barra de estado con el porcentaje total de contexto, las ventanas del plan de 5 horas y de 7 días, el coste de la sesión y un aviso único al 80%. Context Bar no muestra uso del plan ni coste; en su lugar desglosa el contexto por categoría, así que puedes ver si el espacio se lo llevan las herramientas MCP, los archivos de memoria o la propia conversación. El README del autor pide Claude Code 2.1.287 o posterior.

La grabación inicia Claude Code con el mod cargado en el pequeño proyecto de demostración y pide a Claude que lea README.md y describa el proyecto en una frase. Cuando el turno termina, la franja sobre el prompt muestra la ventana de contexto dividida por categoría (prompt del sistema, herramientas del sistema, skills, mensajes, espacio libre), el total, por ejemplo 54k of 200k, el punto en el que entra la autocompactación y el porcentaje usado.

Usa cualquiera de los métodos del bloque de instalación; instalan directamente desde el marketplace del propio autor. La barra aparece en el siguiente inicio de sesión, y /context-bar la oculta o la muestra.

El mod guarda la última lectura en un átomo de $.state que mantiene el host, de modo que sobrevive a una recarga en caliente, y la vuelve a dibujar en el punto de renderizado AbovePrompt. Esta es la función de actualización de hooks/register.tsx:

// Asks the engine for /context's breakdown, estimated locally (no token-count calls).
async function refresh($: EngineInterface) {
  if (await read($, isHidden)) return
  const usage = await $.session.usage({ breakdown: 'summary' })
  const b = usage.context.breakdown
  if (!b || !(b.rawMaxTokens > 0)) return // no window to measure against
  await update($, reading, () => toReading(b))
}

refresh se ejecuta en session.start, en turn.complete cuando no hay agentId (los turnos de subagentes se omiten) y en session.compact, porque un /compact vacía la ventana sin que termine ningún turno. toReading descarta las categorías diferidas y las vacías, ordena las filas usadas antes del espacio libre y del búfer, y asigna los colores. Las funciones puras cells y legend convierten la lectura en tramos de barra y líneas de leyenda: cada categoría usada recibe al menos una celda, y los restos del redondeo van primero al espacio libre. Por debajo de 20 columnas de ancho interior la barra no se dibuja. Cuando una encuesta ocupa el espacio sobre el prompt, la franja se aparta.

No hay opciones en /config. El único interruptor es el comando /context-bar, cuyo estado oculto/visible se guarda con $.store. Para cambiar el aspecto, edita las constantes al principio de register.tsx: PALETTE para los colores de las categorías, MESSAGES para el color de los mensajes, GLYPH para los caracteres de la barra y MIN_WIDTH para el ancho mínimo en el que todavía se dibuja.

Leemos todos los archivos que el plugin puede ejecutar antes de ponerlo en marcha: hooks/hooks.json, hooks/register.tsx, las declaraciones de tipos y los tests. No hay package.json, script de instalación ni código empaquetado.

Modifica la interfaz cubre la franja sobre el prompt. Añade comandos/herramientas cubre /context-bar. El mod lee las cifras de contexto a través de $.session.usage, guarda un único valor verdadero/falso con $.store y mantiene su lectura en $.state. No ejecuta comandos de shell, no lee ni escribe archivos, no usa la red, no lee variables de entorno ni llama al modelo. claude plugin validate no informó de errores ni avisos, y los 6 tests del autor pasaron en Claude Code 2.1.291.

Comprobado con Claude Code 2.1.291 en macOS (validate y tests). Si la barra no aparece:

• claude --version es 2.1.287 o posterior.
• No la ocultaste antes: ejecuta /context-bar una vez y busca "Context bar on".
• La terminal es lo bastante ancha: la franja necesita al menos 24 columnas.
• Hay una encuesta abierta sobre la entrada; la franja vuelve cuando se cierra.
• El desglose solo está disponible cuando Claude Code conoce el tamaño de la ventana. Si la franja falta justo al principio, envía un prompt.