Documentation / Commandes
gain, dashboard et receipt
Mis à jour le
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 |
--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%)
metered: 630600815 (77861 events) is what the server's ingest counts — …
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é.metered:est ce que tokenade.net décompte pour votre offre. Sa déduplication est plus grossière, d'où unsaved:parfois légèrement supérieur.- 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. Seul mode qui accepte --days |
--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 1.2.2
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. Les chiffres de votre compte tokenade.net viennent des décomptes d'usage décrits dans Confidentialité et données.