Token Weather: previsión del contexto de Claude Code en una línea

Token Weather es un mod de la comunidad de Hamza Zafar (hamzafer), parte de su colección claude-code-mods. Ofrece una previsión del contexto de Claude Code en una sola línea sobre el prompt: una palabra del tiempo con su icono para indicar cuánto se ha llenado la ventana, el porcentaje, los tokens frente al tamaño de la ventana, un sparkline de los últimos turnos y una cuenta atrás de cuánto tiempo seguirá caliente la caché de prompts.

La previsión va de ☀ Clear (menos del 25 %) pasando por ☁ Cloudy, ☂ Showers y ☇ Storm hasta ↯ Compact soon con el 90 % o más. Al lado, last turns dibuja hasta 12 lecturas con ▁▂▃▄▅▆▇█, escaladas a la mayor de ellas, seguidas de cuánto subió o bajó el último turno, como ▲ +39.4k last turn. Si la línea es lo bastante ancha, ❄ cache 4:12 cuenta atrás hasta que expira la caché, se vuelve amarillo en el último minuto y después muestra ❄ cache cold.

Token Weather se solapa con nuestros Context Bar, Context Meter y Cache Clock. Context Bar desglosa la ventana por categorías; Context Meter pone el porcentaje y el uso del plan en la línea de estado; Cache Clock muestra detalles de la caché bajo la línea de estado. Token Weather da un veredicto en una línea y la tendencia. El marketplace del autor lo lista en la versión 0.2.2.

La grabación inicia Claude Code con el mod cargado en el pequeño proyecto de demostración. Antes de cualquier prompt, la línea sobre la entrada dice ☀ Clear 0% of context 0 / 1M. Luego le pedimos a Claude que lea README.md y diga en una frase qué es el proyecto. Mientras corre la primera petición aparece una cuenta atrás ❄ cache 5:00. Al terminar el turno, la línea muestra ☀ Clear 4% of context 39.4k / 1M, un sparkline, ▲ +39.4k last turn y ❄ cache 60:00, porque la respuesta escribió una caché de una hora.

Usa cualquiera de los métodos del bloque de instalación; instalan directamente desde el marketplace del autor. La línea aparece al iniciar la siguiente sesión. El plugin tiene una sola opción: la duración de la caché de prompts.

El mod guarda sus lecturas en átomos $.state que mantiene el host, así que sobreviven a una recarga en caliente. Se toma una lectura al iniciar la sesión y tras cada turno del agente principal, con las cifras de contexto de $.session.usage. El reloj de la caché se reinicia cuando termina cada petición de modelo del hilo principal, incluidas las del bucle de herramientas dentro de un turno. Este es el manejador de turn.step, de hooks/register.tsx:

on('turn.step', async function* ($, e, next) {
  const result = yield* next(e)
  if (!e.agentId && result.stopReason !== null) {
    const now = await $.clock.now()
    await update($, lastRequestAt, () => now)
    restart($, now, now, await ttlMsFor($, override))
  }
  return result
})

En modo auto, tras cada turno lee el último megabyte de la transcripción de la sesión (<config dir>/projects/<project>/<session id>.jsonl) y busca tokens de 1 hora o de 5 minutos en cache_creation de la última respuesta del hilo principal. Guarda el resultado en el almacén del plugin para la siguiente sesión. Un temporizador redibuja la línea cuando cambia el texto de la cuenta atrás: cada 30 segundos con más de diez minutos restantes, cada 15 segundos por debajo y cada segundo en los últimos dos minutos.

La única opción es cacheTtl en los ajustes del plugin: auto (por defecto), 5m o 1h. Un valor fijo prevalece sobre la detección. Los tramos de la previsión, el historial de 12 lecturas y el aviso de 60 segundos son constantes al principio de register.tsx. El mod también lee un archivo de orden opcional, <config dir>/claude-code-mods/bands.json, que fija el orden cuando varios mods de bandas del mismo autor se dibujan sobre el prompt.

Antes de ejecutarlo leímos cada archivo que el plugin puede ejecutar: .claude-plugin/plugin.json, hooks/hooks.json, hooks/register.tsx, hooks/bands.ts, las declaraciones de tipos y los tres archivos de pruebas. No hay package.json, script de instalación, binario ni código empaquetado, y el texto que dibuja se construye a partir de números; no inyecta nada en el prompt del modelo. El repositorio incluye un LICENSE MIT.

Lo que hace, en su totalidad:

• Red: ninguna.
• Procesos: uno, tail -c 1048576 <ruta de la transcripción>, solo cuando la transcripción supera 1 MB. En otro caso lee el archivo directamente.
• Archivos que lee: tu propia transcripción de sesión (para detectar la duración de la caché), el bands.json opcional del directorio de configuración de Claude y los ajustes de Claude Code mediante $.settings.read (para ver si está configurada la línea de estado de Cache Clock). Lee las variables de entorno HOME y CLAUDE_CONFIG_DIR para encontrarlos.
• Archivos que escribe: ninguno directamente. Guarda la duración de caché detectada (5m o 1h) con $.store, el almacén propio del plugin.
• Trabajo en segundo plano: un temporizador de redibujado dentro de Claude Code, que se detiene al terminar la sesión. Sin demonios.
• Bloqueos: ninguno. No bloquea ni reescribe llamadas a herramientas ni prompts.

claude plugin validate no informó de errores ni de advertencias del propio plugin (el comprobador de directorio señala que falta un icono). Las 24 pruebas del autor pasaron con Claude Code 2.1.307.

Probado con Claude Code 2.1.307 en macOS (validate, pruebas y grabación). Si la línea no aparece:

• Iniciaste una sesión nueva tras la instalación; el mod se carga al iniciar la sesión.
• No hay una encuesta abierta sobre la entrada. La línea se aparta ante las encuestas y vuelve después.
• La ventana tiene al menos 60 columnas. En terminales más estrechas solo se muestran la palabra del tiempo, el porcentaje y los tokens.
• Si la cuenta atrás no cuadra, pon cacheTtl en 5m o 1h en lugar de auto. Una ruta de proyecto muy larga o un proyecto movido durante la sesión pueden impedir encontrar la transcripción; entonces se mantiene el último valor detectado.
• Tras /clear o al reanudar, la cuenta atrás permanece oculta hasta la siguiente petición.