Context Inspector: encuentra el desperdicio de contexto en Claude Code

Context Inspector es un mod de la comunidad de YeonwooSung (my-claude-code-mods) que busca el desperdicio de contexto en Claude Code. Lleva un libro de registro de todo lo que entra en la conversación (prompts, respuestas, resultados de herramientas, adjuntos) y responde tres preguntas: qué llena la ventana ahora, por qué la misma información vuelve una y otra vez, y qué conservó o perdió una compactación.

Añade una línea de estado como ctx 62% · waste≈8.1k, donde el porcentaje es medido y el desperdicio es estimado. También añade tres comandos. /context-inspect imprime un informe de texto con las secciones overview, occupants, rereads, similar, compactions, efficiency y advice. /context-pane abre un panel en vivo. /context-export guarda el libro de registro como JSONL, solo metadatos.

Los análisis son concretos. Las relecturas de un archivo se clasifican, por ejemplo como sin cambios mientras la copia anterior sigue en la ventana (desperdicio puro), tras una edición o tras una compactación. Las salidas de herramientas casi duplicadas se agrupan con un SimHash léxico, no por significado. Tras una compactación, comprueba si los archivos editados y leídos, los errores y los identificadores de usuario siguen apareciendo en el resumen. El README del autor requiere 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 le pide a Claude que lea README.md y diga en una frase qué es el proyecto. Cuando termina el turno, el pie muestra context-inspector: ctx 4% · waste≈0. Después ejecutamos /context-inspect. El informe lista los tokens vivos (unos 6,2k en 17 elementos), los principales ocupantes por categoría (los adjuntos de lista de skills, instrucciones de MCP y herramientas diferidas), relecturas, salidas similares, compactaciones, eficiencia y consejos. En esta sesión corta no se leyó nada dos veces, así que el desperdicio es cero y los consejos indican que nada destaca.

Usa cualquiera de los métodos del bloque de instalación; instalan directamente desde el marketplace del propio autor. La línea de estado aparece tras el siguiente inicio de sesión, cuando se completa el primer turno.

El módulo es una sola función register en hooks/register.tsx que envuelve los eventos y los pasa sin cambios. Cada paso de registro pasa por un ayudante que se traga sus propios errores, así que el inspector no puede romper una sesión. Una llamada a herramienta se registra antes y después de ejecutarse, y la respuesta se devuelve tal como llegó:

on('tool.call', async ($, e, next) => {
  const id = e.tool_use_id
  if (id !== undefined) safe(() => ingestToolCall(ledger, id, String(e.tool), e.agentId, e as unknown as Record<string, unknown>))
  const answer = await next(e)
  if (id !== undefined) safe(() => ingestToolResult(ledger, id, answer))
  return answer
}).catch(($, e, next) => next(e))

El fragmento es de hooks/register.tsx. Las filas llegan por session.append, los tamaños medidos de las peticiones por turn.step y las compactaciones por session.compact. Tras cada turno, turn.complete encola un repintado que lee $.session.usage() y escribe la línea de estado. El código de análisis de hooks/core/ es TypeScript simple con solo importaciones locales, y el libro de registro está limitado a 20 000 elementos.

/config tiene dos opciones. outputDir indica dónde escribe /context-export; vacío significa ~/.claude/context-inspector. toastAdvice (activada por defecto) muestra un aviso por sesión la primera vez que aparece una recomendación de severidad alta. Los comandos aceptan argumentos: /context-inspect advice muestra una sola sección y --agents incluye los subagentes.

Leímos todos los archivos que el plugin puede ejecutar antes de correrlo: el manifiesto, hooks/hooks.json, hooks/register.tsx y todo hooks/core/, incluidas las reglas de enmascaramiento. No hay package.json, script de instalación, binario ni código empaquetado, y las únicas importaciones son archivos locales.

• Red, procesos, demonios, telemetría: ninguno. Ni fetch, ni comandos de shell, ni nada que siga funcionando tras cerrar Claude Code.
• Cambia la interfaz: la línea de estado, un aviso y el panel. Añade comandos: los tres de arriba.
• Observa cada llamada a herramienta y cada fila mediante tool.call, session.append, turn.step y session.compact. Son hooks de control, pero cada uno devuelve sin cambios el resultado del siguiente manejador y tiene un .catch de respaldo; no se bloquea ni se reescribe nada. validate también señala que los hooks de session.compact no se ejecutan en un plugin instalado por una persona cuando una organización gestiona Claude Code, salvo que la organización lo incluya en la configuración gestionada.
• Escrituras de archivos: solo con /context-export, mediante $.fs.write, en <outputDir>/<id de sesión>/context-<load>-<n>.jsonl. Por defecto está dentro de ~/.claude, en la subcarpeta propia del plugin. Lee HOME para expandir ~. Las rutas de archivo se exportan tal cual y los demás destinos se enmascaran en la medida de lo posible; el autor recomienda revisar las exportaciones antes de compartirlas.
• Influencia en los prompts: no se encontró ninguna. No inyecta texto en prompts ni en resultados de herramientas; los consejos solo te los muestra a ti.
• Requisitos externos: ninguno. Licencia: Apache-2.0, con archivo LICENSE en la raíz del repositorio.

claude plugin validate no informó de errores ni advertencias, solo de las notas anteriores. Las 102 pruebas del autor pasaron en Claude Code 2.1.303.

Comprobado con Claude Code 2.1.303 en macOS (validate y pruebas). Si falta la línea de estado:

• claude --version es 2.1.287 o posterior.
• Ya se completó un turno; la línea se pinta después de turn.complete.
• /context-inspect imprime el informe incluso sin línea de estado, así que sirve para comprobar que el mod está cargado.
• En el panel de chat de VS Code solo funcionan los hooks y el texto de los comandos; usa /context-inspect.

Límites conocidos del README: tras una recarga, reanudación o /clear el libro de registro empieza de nuevo, y la supervivencia a la compactación se juzga por coincidencia de subcadenas, así que lo que el resumen parafrasea cuenta como perdido.