monitor-ccu
Un dashboard local qui lit les fichiers de session de Claude Code et te montre où partent tes tokens. Conçu et maintenu par tiber76 — je n'en suis qu'utilisateur reconnaissant.
Ce que c'est
monitor-ccu est un petit serveur local qui lit les fichiers de session JSONL de Claude Code (dans `~/.claude/projects/**/*.jsonl`) et expose un dashboard web sur `http://localhost:3333`. Il agrège : coût, tokens d'entrée / sortie / cache, modèle utilisé, tool calls, latence, sessions actives, sous-agents.
Il existe aussi `monitor-codex` (par le même auteur) qui fait le même travail pour OpenAI Codex en lisant `~/.codex/sessions/**/*.jsonl` sur le port 3334. Les deux peuvent tourner en parallèle, ce qui permet de comparer Claude et Codex sur des tâches comparables.
Comment ça marche
Pas d'API key, pas d'envoi de données externe. Le serveur fait du polling local sur les fichiers de session écrits par Claude Code lui-même. Tu lances `monitor-ccu`, tu ouvres `localhost:3333`, et tu vois en temps quasi-réel ce que ta journée coûte.
Côté UX, le dashboard montre les KPIs qui comptent : coût par feature ou par projet, taux de cache hit, taux de tool-call, taux de refus, latence p50 / p95 / timeout, top 10 des prompts les plus chers. C'est l'équivalent d'un Grafana mais pour ton agent.
Comment l'installer
Cloner le repo, installer les dépendances, lancer :
git clone https://github.com/tiber76/monitor-ccu
cd monitor-ccu
yarn install # ou npm install
yarn start # serveur sur localhost:3333
Ouvrir `http://localhost:3333` — le dashboard charge les sessions présentes dans `~/.claude/projects/`. Pas de configuration nécessaire.
Comment je l'utilise au quotidien
Je le laisse tourner en permanence dans un onglet. Quand je ne comprends pas pourquoi une journée est plus chère qu'une autre, j'y vais : je vois en deux clics quel sous-agent a explosé son budget ou quelle commande a déversé trop de logs.
C'est aussi le seul moyen honnête de mesurer l'impact d'une optimisation : avant / après l'ajout d'un CLAUDE.md plus compact, avant / après l'installation de RTK, avant / après le routing par profondeur. Sans ce dashboard, je serais réduit à des intuitions.
Sources & crédits
monitor-ccu et monitor-codex sont conçus et maintenus par `tiber76`. Le crédit complet du design et de l'implémentation lui revient.