context-mode ventana de contexto de agentes: es un proyecto que ataca la ventana de contexto de los agentes de código; mantiene la salida en bruto de las herramientas fuera de la conversación, conserva el estado de la sesión en una base de datos local y enruta las llamadas mediante MCP y hooks. El repositorio mksglu/context-mode cuenta con unas 30 200 estrellas a mediados de octubre de 2026, y su descripción anuncia 17 plataformas compatibles.
La promesa, un contexto que se llena más despacio, es también una promesa de operación: menos tokens de entrada por turno, menos coste, menos compactaciones. Pero las cifras del README son las del autor. Este artículo presenta el proyecto, explica con precisión su licencia (que no es una licencia de código abierto) y propone después un protocolo para medir por ti mismo los tokens ahorrados con OpenTelemetry. Aclaración de honestidad: span.observer no ha instalado este software; los comandos proceden del README y las capturas son extractos renderizados a partir de ese archivo.
context-mode ventana de contexto de agentes: lo que dice el repositorio
- Licencia: Elastic License 2.0 (ELv2), detallada más abajo; el copyright de 2026 figura a nombre del mantenedor del repositorio.
- Cifras releídas el 16 de octubre de 2026: unas 30 200 estrellas, unos 2 100 forks, 2 235 commits; el
package.jsonde la rama principal indica la versión 1.0.169 y exige Node.js 22.5 o posterior. La página de releases muestra la v1.0.169, fechada el 29 de junio (sin año). - Mecanismo: un servidor MCP que expone 11 herramientas (seis herramientas de sandbox, cinco metaherramientas) y, para Claude Code, hooks (PreToolUse, PostToolUse, UserPromptSubmit, PreCompact, SessionStart, Stop).
Se trata de una herramienta local, independiente de Dynatrace, que se observa en el lado del agente: el razonamiento vale tanto para Dynatrace SaaS como para Dynatrace Managed, ya que se apoya en métricas de OpenTelemetry.
La licencia ELv2: código disponible, no código abierto
El propio README lo dice: la licencia es «source-available». El texto de la ELv2 concede una licencia mundial, gratuita y no exclusiva para usar, copiar, distribuir, poner a disposición y crear obras derivadas, con tres límites:
- no ofrecer el software a terceros como servicio alojado o gestionado que dé acceso a una parte sustancial de sus funciones;
- no eludir ni desactivar una eventual función protegida por clave de licencia;
- no retirar ni ocultar los avisos de licencia y de derechos de autor.
La licencia prevé además una licencia de patente que termina si afirmas por escrito que el software infringe una patente, y una resolución automática en caso de infracción. Nada en estos límites prohíbe un uso interno en tu empresa. Pero una licencia que restringe un ámbito de uso (aquí, la oferta como servicio alojado) no entra en la definición de código abierto de la OSI: no la presentes como tal en un inventario de dependencias. Si piensas integrar el software en un producto o servicio ofrecido a clientes, haz que tu departamento jurídico revise la licencia. Esto no es un asesoramiento jurídico.
Cómo funciona context-mode
El README describe cuatro ideas. Primero, el sandbox: la herramienta ctx_execute lanza el código en un subproceso aislado y solo la salida estándar entra en el contexto; los datos en bruto (logs, respuestas de API, snapshots) no salen de ahí. Después, la base de conocimiento: ctx_index trocea markdown en una tabla SQLite FTS5 y ctx_search la consulta con una clasificación BM25. Luego, la continuidad de sesión: eventos almacenados en una base SQLite por proyecto, restaurados tras la compactación. Por último, el enrutamiento mediante hooks, que redirige al sandbox las llamadas que inundarían el contexto.

El proyecto se presenta además como algo que no «saca nada de la máquina»: sin telemetría, sin sincronización en la nube. Sin embargo, el mismo README describe un comando ctx insight que abre un dashboard alojado: comprueba qué transita realmente antes de un uso en la empresa.
Instalación paso a paso
Paso 1 — Instalar en Claude Code
El README pide Claude Code 1.0.33 o posterior, y da después dos comandos de plugin y un comando de diagnóstico. También propone una instalación solo MCP, sin hooks ni enrutamiento automático:

El diagnóstico /context-mode:ctx-doctor valida los runtimes, los hooks, FTS5 y el registro del plugin. Para otros clientes (Gemini CLI, Cursor, Codex CLI…), el README da una instalación global con npm install -g context-mode y después un archivo de configuración propio de cada cliente.
Paso 2 — Activar la telemetría del agente
Las cifras de ctx_stats proceden de la propia herramienta. Para una cifra independiente, mide en origen, en el lado del agente. Claude Code exporta en OpenTelemetry la métrica claude_code.token.usage, desglosada por type: input, output, cacheRead y cacheCreation. El input excluye los tokens leídos o escritos en la caché de prompt. Para una prueba local sin backend, basta el exportador de consola:
export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=console
export OTEL_METRIC_EXPORT_INTERVAL=10000
claude
Para enviar a Dynatrace, retoma la configuración OTLP de supervisar un agente de código en la empresa (OTLP por HTTP, métricas con temporalidad delta). La clave de la métrica puede recibir un sufijo durante la ingesta: compruébala antes de construir un tile.
Paso 3 — Comparar dos sesiones
Toma una tarea de referencia que produzca mucha salida (analizar un log grande, recorrer el historial de Git). Lánzala en una sesión nueva con el plugin desactivado y después en una sesión nueva con el plugin activo, con el mismo repositorio, el mismo modelo y el mismo prompt. Repite varias veces: un LLM no es determinista.
timeseries tokens = sum(claude_code.token.usage), by:{type}, interval:5m
Suma los cuatro tipos, no solo input; de lo contrario, un desplazamiento de tokens hacia la caché pasa por un ahorro. Fundamentos de esta sintaxis: nuestra ficha de DQL filter, summarize y timeseries (Dynatrace SaaS; en Dynatrace Managed, usa el metric selector).
Paso 4 — Mirar el tamaño de los resultados de las herramientas
El evento claude_code.tool_result lleva tool_name, duration_ms y tool_result_size_bytes. Compara el tamaño de los resultados entre las dos sesiones: con el sandbox, las llamadas que devolvían decenas de kilobytes deberían devolver unos cientos de bytes.
Lo que las cifras del README no prueban
El README anuncia ahorros del 94 al 100 % según el escenario, lo cual es coherente con el mecanismo descrito, pero son mediciones del autor sobre sus escenarios.

Tu balance neto depende de tu carga de trabajo. Hay que restarle el coste fijo: 11 definiciones de herramientas MCP e instrucciones inyectadas por los hooks, presentes en cada turno. Una tarea que produce poca salida puede no ganar nada. Esa es la razón de ser de la medición: el coste de un agente se lee en tokens por tarea, como en nuestro artículo sobre el coste de un agente de IA, y el tamaño de la ventana es un criterio de elección del modelo, consulta cómo elegir tu LLM. Si tu agente no es Claude Code, los atributos gen_ai.usage.* y una plataforma como Langfuse cumplen el mismo papel.
Límites y puntos abiertos
- Licencia ELv2: ninguna oferta como servicio alojado, ninguna etiqueta «código abierto».
- El software se inserta en el bucle de llamadas a herramientas mediante hooks: es un componente crítico que hay que vigilar, igual que un servidor MCP (consulta cómo proteger un servidor MCP).
- El estado de sesión y el índice viven en SQLite dentro de tu carpeta de usuario: inclúyelos en tu reflexión sobre los datos (
ctx_purgelos elimina). - La memoria de un agente es un asunto más amplio, consulta Hindsight, y el proyecto cita el ecosistema OpenClaw entre los clientes admitidos.
Cómo comprobar que funciona
/context-mode:ctx-doctormuestra todas las comprobaciones marcadas.- El análisis de un archivo grande pasa por
ctx_executeoctx_execute_filey solo devuelve la salida útil. - En tus métricas, la suma de tokens por tarea baja en la tarea de referencia, sin degradar el resultado.
Buenas prácticas
- Mide antes de adoptar: de tres a cinco repeticiones por configuración.
- Compara a igual calidad: un contexto más pequeño no vale nada si el agente se equivoca más a menudo.
- Documenta la licencia en el inventario de tus dependencias y fija la versión.
Preguntas frecuentes
¿Es context-mode de código abierto?
No, en el sentido de la OSI. El código es legible y modificable bajo ELv2, pero la licencia prohíbe ofrecerlo como servicio alojado.
¿Se puede usar context-mode en la empresa?
El texto de la licencia autoriza el uso interno. Haz validar por tu departamento jurídico el caso de un producto o servicio para clientes.
¿Cómo saber cuántos tokens ahorra?
Compara sesiones con y sin el plugin con claude_code.token.usage, sumando todos los tipos de tokens, en lugar de fiarte solo de ctx_stats.
Conclusión
context-mode propone una idea sencilla, mantener los datos en bruto fuera del contexto, y la implementa con herramientas MCP y hooks. Sus cifras son las del autor; la medición con OpenTelemetry las convierte en cifras tuyas. Fuentes: repositorio mksglu/context-mode.
span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC ni a los proyectos citados. Las marcas citadas pertenecen a sus propietarios. Las herramientas evolucionan rápido: comprueba los comandos y las opciones en su documentación oficial.