# gain, dashboard et receipt

> Combien de tokens Tokenade vous a fait économiser : gain affiche les totaux, dashboard ouvre un rapport web local, receipt signe les chiffres.

Source: https://tokenade.net/fr/docs/gain-dashboard-receipt · Updated: 2026-10-16

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](https://tokenade.net/fr/docs/savings-measurement).

## gain

```text
tokenade gain [--json | --history] [--by-source] [--recent]
```

| 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, …) |

```text
$ tokenade gain
─── 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 de `saved:` 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 de `saved:`.

## dashboard

```text
tokenade dashboard [--text | --no-open | --html [<path>] | --json | --watch [<secs>]]
```

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 |

```text
$ tokenade dashboard --text
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
   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

```text
tokenade receipt [--json] [--verify <file>]
```

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.

```text
$ tokenade receipt
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   …
```

```bash
tokenade receipt --json > receipt.json
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

```text
tokenade cache-note [--saved N] [--fresh F]
```

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.

```text
tokenade mcp-stats [--json]
```

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.

```text
$ tokenade mcp-stats
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 : `gain` et `dashboard` montrent donc tous vos projets ensemble. La section PROJECTS les sépare.
- [`tokenade evict-stale`](https://tokenade.net/fr/docs/maintenance) supprime les lignes de bruit sans économie. Lancez-le avant un rapport à transmettre si vous voulez des totaux propres.
- Le dashboard est local, comme `gain` et 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](https://tokenade.net/fr/docs/privacy-telemetry).

## Voir aussi

- [Comment les économies sont mesurées](https://tokenade.net/fr/docs/savings-measurement)
- [Compaction des sorties et stash](https://tokenade.net/fr/docs/compaction)
- [style et statusline](https://tokenade.net/fr/docs/style-statusline)
- [Confidentialité et données](https://tokenade.net/fr/docs/privacy-telemetry)
