gain, dashboard et receipt
Mis à jour le
tokenade gain affiche vos économies par compacteur ; tokenade dashboard (alias dash, stats) ouvre un rapport web local ; tokenade receipt produit un récapitulatif signé et vérifiable. Tous lisent ~/.tokenade/gain.jsonl et n'utilisent jamais le réseau.Ces commandes montrent ce que Tokenade a économisé. gain donne la vue rapide dans le terminal, dashboard le rapport local complet, et receipt transforme les totaux en un relevé signé, infalsifiable sans que cela se voie. Les trois lisent le même registre local, ~/.tokenade/gain.jsonl, et aucun ne contacte le réseau.
Le calcul de chaque chiffre est expliqué dans Comment les économies sont mesurées.
gain
| Option | Effet |
|---|---|
| (aucune) | Totaux, puis une ligne par compacteur (by op:) |
--json | Sortie structurée. Niveau supérieur : version, operations, before, after, saved, percent ; tableaux by_op[] et by_source[] avec before, after, count, saved, percent |
--history | Affiche aussi une ligne par entrée du registre, pour vérifier au cas par cas |
--recent | Seulement les 7 derniers jours du registre |
--by-source | Ajoute une section by source: (hook, cli, wrap, …) |
─── tokenade gain (everything recorded: 133 days, since 2026-05-28) ───
operations: 77893
tokens: 679170720 → 48388143
saved: 630782577 (92.9%)est.: 864678 more where the input WAS measured but the alternative is assumed (skeleton/query/map — …)
both excluded from `saved:` and from `operations:` above …
by op:
auto-compact 2273× −91%
auto:accesslog 1× −99%
…
Comment lire ces lignes :
saved:est mesuré : nombres réels de tokens avant et après ce que Tokenade a modifié.of which:(affiché seulement quand il y a lieu) est la part desaved:créditée au plafond de livraison : des sorties que l'agent aurait refusées en bloc plutôt que tronquées. Elle reste dans le total, avec son étiquette.- Les lignes
est.:sont des estimations (intelligence de code, où l'alternative évitée est supposée). Elles sont exclues desaved:.
dashboard
Alias : dash, stats. Sans option, la commande écrit ~/.tokenade/dashboard.html et l'ouvre dans votre navigateur. La page est un fichier local statique : un sélecteur de période qui pilote tous les panneaux, un détail par fonction, couche, agent, projet et modèle, une comparaison avec et sans Tokenade, et un onglet « outside tokenade » qui montre le trafic de l'agent que Tokenade n'a pas touché. Pas de serveur, pas de requêtes, pas de télémétrie.
| Option | Effet |
|---|---|
--text | Affiche le rapport dans le terminal à la place. Accepte --days N (30 par défaut), comme --watch ; la page a son propre sélecteur de période |
--no-open | Écrit la page et affiche son chemin, sans ouvrir de navigateur |
--html [<path>] | N'écrit que la page, vers <path> ou l'emplacement par défaut |
--json | Sortie structurée : operations, tokens_before/after/saved, savings_pct, cache_hits/misses/hit_rate, by_layer[], per_op[] |
--watch [<secs>] | Redessine le rapport texte toutes les <secs> secondes (2 par défaut, de 1 à 3600). Ctrl-C pour quitter. Incompatible avec --html et --json |
En SSH ou sans affichage graphique, le rapport s'affiche automatiquement dans le terminal. Ses sections :
| Section | Contenu |
|---|---|
| En-tête | Tokens économisés, pourcentage et nombre d'opérations sur la période |
| TOP COMPACTORS | Économies mesurées par compacteur |
| BY LAYER | Les mêmes économies regroupées : shell, file-read, content-auto, web, wrapped-mcp |
| WRAPPED MCPs | Serveurs MCP tiers routés via Tokenade (seulement s'il y a ce trafic) |
| PROJECTS | Totaux par projet |
| CODE INTELLIGENCE | Estimations heuristiques pour skeleton, query, map, impact, semantic |
| AGENT TOKENS | Ce que votre agent a consommé hors de Tokenade, lu dans ses transcriptions locales |
| INDEX & CACHE | Taux de réussite du cache de déduplication et taille de l'index sémantique |
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
24.3M measured · 85.6% · 6439 ops
last 30 days · lifetime saved: 631.9M
+ 759.5k estimated (code-intelligence heuristic)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
── TOP COMPACTORS ──────────────────────────────────────────
html-to-markdown ██████████████████████████████ 127× saved 6.1M 92.4%
auto-compact █████████████████░░░░░░░░░░░░░ 380× saved 3.4M 90.3%
…
── BY LAYER ────────────────────────────────────────────────
web ███████████████████░░░░░░░░░░░ 234× saved 6.3M 91.3%
shell ████████████░░░░░░░░░░░░░░░░░░ 2183× saved 3.9M 88.2%
…
Les montants valorisent chaque token au tarif du modèle qui l'a réellement traité.
receipt
Alias : savings-receipt. Agrège le registre (événements, tokens avant, après et économisés) et le signe avec une clé propre à l'installation, conservée dans ~/.tokenade/. Utile quand vous devez transmettre vos économies à quelqu'un sous une forme qu'il peut vérifier.
tokenade savings receipt
────────────────────────
machine …
generated 1791392491 (unix)
version 2.0.1
events 77894
before 679171307 tokens
after 48388476 tokens
saved 630782831 tokens (92.9%)
pubkey …
signature …
tokenade receipt --verify receipt.json # exit 0 intact, 1 tampered
La génération d'un reçu ne contacte jamais le réseau.
cache-note et mcp-stats
Présente les économies en tenant compte du cache de prompt. --saved vaut par défaut votre total cumulé ; --fresh est la part de sortie non mise en cache, entre 0 et 1 (1.0 par défaut). Les économies pèsent surtout sur les sorties d'outils fraîches : une relecture déjà en cache est facturée à un tarif bien plus bas, quelle que soit sa taille.
Fait le point sur votre configuration MCP (serveurs configurés et serveurs enveloppés par Tokenade) et sur le coût en tokens de vos skills.
tokenade mcp-stats
MCP manifests: 0 config(s), 0 server(s), 0 wrapped (0%), 0 unwrapped
skills: 0 indexed · eager 0 tok → index 0 tok (saves 0 tok on disclose)
Pièges
- Tous les projets écrivent dans le même registre global :
gainetdashboardmontrent donc tous vos projets ensemble. La section PROJECTS les sépare. tokenade evict-stalesupprime les lignes de bruit sans économie. Lancez-le avant un rapport à transmettre si vous voulez des totaux propres.- Le dashboard est local, comme
gainet la barre d'état : chaque chiffre est calculé sur votre machine à partir de votre registre local, et rien n'est envoyé nulle part. Voir Confidentialité et données.