context-mode est un projet qui s’attaque à la fenêtre de contexte des agents de code : il garde la sortie brute des outils hors de la conversation, conserve l’état de la session dans une base locale et route les appels via MCP et des hooks. Le dépôt mksglu/context-mode compte environ 30 200 étoiles à la mi-octobre 2026, et sa description annonce 17 plateformes prises en charge.
La promesse, un contexte qui se remplit moins vite, est aussi une promesse d’exploitation : moins de tokens d’entrée par tour, moins de coût, moins de compactions. Mais les chiffres du README sont ceux de l’auteur. Cet article présente le projet, explique avec précision sa licence (qui n’est pas une licence open source), puis propose un protocole pour mesurer soi-même les tokens économisés avec OpenTelemetry. Précision d’honnêteté : span.observer n’a pas installé ce logiciel ; les commandes viennent du README et les captures sont des extraits rendus à partir de ce fichier.
context-mode : ce que dit le dépôt
- Licence : Elastic License 2.0 (ELv2), détaillée plus bas ; le copyright 2026 est au nom du mainteneur du dépôt.
- Chiffres relus le 16 octobre 2026 : environ 30 200 étoiles, environ 2 100 forks, 2 235 commits ; le
package.jsonde la branche principale indique la version 1.0.169 et exige Node.js 22.5 ou plus récent. La page des releases affiche la v1.0.169, datée du 29 juin (sans année). - Mécanisme : un serveur MCP exposant 11 outils (six outils de bac à sable, cinq méta-outils), et pour Claude Code des hooks (PreToolUse, PostToolUse, UserPromptSubmit, PreCompact, SessionStart, Stop).
Il s’agit d’un outil local, indépendant de Dynatrace, que l’on observe côté agent : le raisonnement vaut pour Dynatrace SaaS comme pour Dynatrace Managed, puisqu’il repose sur des métriques OpenTelemetry.
La licence ELv2 : source disponible, pas open source
Le README le dit lui-même : la licence est « source-available ». Le texte de l’ELv2 accorde une licence mondiale, gratuite, non exclusive pour utiliser, copier, distribuer, rendre disponible et créer des œuvres dérivées, sous trois limites :
- ne pas fournir le logiciel à des tiers comme service hébergé ou géré donnant accès à une part substantielle de ses fonctions ;
- ne pas contourner ni désactiver une éventuelle fonction protégée par clé de licence ;
- ne pas retirer ni masquer les mentions de licence et de droits d’auteur.
La licence prévoit aussi une licence de brevet qui prend fin si vous revendiquez par écrit que le logiciel viole un brevet, et une résiliation automatique en cas de violation. Rien dans ces limites n’interdit un usage interne dans votre entreprise. Mais une licence qui restreint un domaine d’usage (ici, l’offre en service hébergé) n’entre pas dans la définition de l’open source de l’OSI : ne la présentez pas comme telle dans un inventaire de dépendances. Si vous prévoyez d’embarquer le logiciel dans un produit ou un service proposé à des clients, faites relire la licence par votre service juridique. Ceci n’est pas un avis juridique.
Comment fonctionne context-mode
Le README décrit quatre idées. D’abord le bac à sable : l’outil ctx_execute lance le code dans un sous-processus isolé et seule la sortie standard entre dans le contexte ; les données brutes (logs, réponses d’API, snapshots) n’en sortent pas. Ensuite la base de connaissances : ctx_index découpe du markdown dans une table SQLite FTS5 et ctx_search l’interroge avec un classement BM25. Puis la continuité de session : événements stockés dans une base SQLite par projet, restaurés après compaction. Enfin le routage par hooks, qui redirige vers le bac à sable des appels qui inonderaient le contexte.

Le projet se présente en outre comme ne faisant « rien sortir de la machine » : pas de télémétrie, pas de synchronisation cloud. Le même README décrit pourtant une commande ctx insight qui ouvre un tableau de bord hébergé : vérifiez ce qui transite réellement avant un usage en entreprise.
Installation pas à pas
Étape 1 — Installer sur Claude Code
Le README demande Claude Code 1.0.33 ou plus récent, puis donne deux commandes de plugin et une commande de diagnostic. Il propose aussi une installation MCP seule, sans hooks ni routage automatique :

Le diagnostic /context-mode:ctx-doctor valide les runtimes, les hooks, FTS5 et l’enregistrement du plugin. Pour d’autres clients (Gemini CLI, Cursor, Codex CLI…), le README donne une installation globale npm install -g context-mode puis un fichier de configuration propre à chaque client.
Étape 2 — Activer la télémétrie de l’agent
Les chiffres de ctx_stats viennent de l’outil lui-même. Pour un chiffre indépendant, mesurez à la source, côté agent. Claude Code exporte en OpenTelemetry la métrique claude_code.token.usage, ventilée par type : input, output, cacheRead et cacheCreation. L’input exclut les tokens lus ou écrits dans le cache de prompt. Pour un test local sans backend, l’exporteur console suffit :
export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=console
export OTEL_METRIC_EXPORT_INTERVAL=10000
claude
Pour envoyer vers Dynatrace, reprenez la configuration OTLP de superviser un agent de code en entreprise (OTLP en HTTP, métriques en temporalité delta). La clé de la métrique peut recevoir un suffixe à l’ingestion : vérifiez-la avant de bâtir une tuile.
Étape 3 — Comparer deux sessions
Prenez une tâche de référence qui produit beaucoup de sortie (analyser un gros journal, parcourir l’historique Git). Lancez-la dans une session neuve avec le plugin désactivé, puis dans une session neuve avec le plugin actif, avec le même dépôt, le même modèle et le même prompt. Répétez plusieurs fois : un LLM n’est pas déterministe.
timeseries tokens = sum(claude_code.token.usage), by:{type}, interval:5m
Additionnez les quatre types, pas seulement input, sinon un déplacement de tokens vers le cache passe pour une économie. Bases de cette syntaxe : notre fiche DQL filter, summarize et timeseries (Dynatrace SaaS ; sur Dynatrace Managed, utilisez le metric selector).
Étape 4 — Regarder la taille des résultats d’outils
L’événement claude_code.tool_result porte tool_name, duration_ms et tool_result_size_bytes. Comparez la taille des résultats entre les deux sessions : avec le bac à sable, les appels qui renvoyaient des dizaines de kilo-octets doivent renvoyer quelques centaines d’octets.
Ce que les chiffres du README ne prouvent pas
Le README annonce des économies de 94 à 100 % selon le scénario, ce qui est cohérent avec le mécanisme décrit, mais ce sont des mesures de l’auteur sur ses scénarios.

Votre bilan net dépend de votre charge de travail. Il faut y soustraire le coût fixe : 11 définitions d’outils MCP et des instructions injectées par les hooks, présentes à chaque tour. Une tâche qui produit peu de sortie peut ne rien gagner. C’est la raison d’être de la mesure : le coût d’un agent se lit en tokens par tâche, comme dans notre article sur le coût d’un agent IA, et la taille de fenêtre est un critère de choix du modèle, voir choisir son LLM. Si votre agent n’est pas Claude Code, les attributs gen_ai.usage.* et une plateforme comme Langfuse jouent le même rôle.
Limites et points ouverts
- Licence ELv2 : pas d’offre en service hébergé, pas d’étiquette « open source ».
- Le logiciel s’insère dans la boucle des appels d’outils par des hooks : c’est un composant critique à surveiller, au même titre qu’un serveur MCP (voir sécuriser un serveur MCP).
- L’état de session et l’index vivent en SQLite dans votre dossier utilisateur : à inclure dans votre réflexion sur les données (
ctx_purgeles supprime). - La mémoire d’un agent est un sujet plus large, voir Hindsight, et le projet cite l’écosystème OpenClaw parmi les clients pris en charge.
Comment vérifier que ça fonctionne
/context-mode:ctx-doctoraffiche toutes les vérifications cochées.- Une analyse de gros fichier passe par
ctx_executeouctx_execute_fileet ne renvoie que la sortie utile. - Sur vos métriques, la somme des tokens par tâche baisse sur la tâche de référence, sans dégrader le résultat.
Bonnes pratiques
- Mesurez avant d’adopter : trois à cinq répétitions par configuration.
- Comparez à qualité égale : un contexte plus petit ne vaut rien si l’agent se trompe plus souvent.
- Documentez la licence dans l’inventaire de vos dépendances et fixez la version.
Questions fréquentes
context-mode est-il open source ?
Non, au sens de l’OSI. Le code est lisible et modifiable sous ELv2, mais la licence interdit de l’offrir comme service hébergé.
Peut-on utiliser context-mode en entreprise ?
Le texte de la licence autorise l’usage interne. Faites valider le cas d’un produit ou d’un service client par votre service juridique.
Comment savoir combien de tokens il économise ?
Comparez des sessions avec et sans le plugin avec claude_code.token.usage, en sommant tous les types de tokens, plutôt que de vous fier au seul ctx_stats.
Conclusion
context-mode propose une idée simple, garder les données brutes hors du contexte, et l’implémente avec des outils MCP et des hooks. Ses chiffres sont ceux de l’auteur ; la mesure avec OpenTelemetry les transforme en chiffres à vous. Sources : dépôt mksglu/context-mode.
span.observer est un blog indépendant de la communauté, non affilié à Dynatrace LLC ni aux projets cités. Les marques citées appartiennent à leurs propriétaires. Les outils évoluent vite : vérifiez les commandes et options dans leur documentation officielle.