Métriques Claude Code et Grok
Code Critter
Un familier pixel qui veille sur vos sessions Claude Code et Grok et réagit en temps réel : app de bureau pour macOS, Windows et Linux, plugin Stream Deck. Sessions live, /loop, tokens, coût et burn rate, le tout lu 100 % en local.
0
appel API · 100% local
App de bureau
Une app de bureau
La version autonome pour macOS, Windows et Linux : un companion dans votre barre de menus (ou la zone de notification sous Windows et Linux) qui affiche vos stats Claude Code et Grok sans Stream Deck. Même moteur que le plugin, donc les chiffres correspondent toujours.
Ce qu’elle fait
Sessions live, fleet, loops, tokens, coût par projet, burn rate, modèles Claude et Grok, compteurs, activité, compte. Affichez, masquez, réordonnez. Burn sur 24 h, 7 j ou 30 j, coût par projet sur 1 j, 7 j, 30 j ou depuis le début : chaque période à un clic.
Une ligne par session en cours, nommée par son titre (votre /rename, le titre automatique de Claude Code ou celui généré par Grok, sinon le dépôt) : temps depuis la dernière activité, anneau de contexte, tokens entrants, tokens sortants, lectures de cache et coût équivalent-API. Cliquez un en-tête pour trier.
Le companion vit en haut de l’écran, à côté de l’horloge. Son humeur suit votre fleet (working, waiting, done), avec un clignotement optionnel quand une session vous attend.
Voyez quelles sessions tournent en boucle : un marqueur ↻, un carré LOOP dans le fleet, une carte Loops dédiée avec cadence et compte à rebours. Lu directement dans le transcript.
Soyez prévenu quand une session vous attend, qu’un travail est livré ou qu’un /loop se termine, même app fermée. Le titre nomme la session ({session_name}), avec des réglages globaux, par session et pour les nouvelles sessions, et une formulation ajustable.
Sur macOS, cliquez une session pour aller droit à sa fenêtre ou son onglet, même en arrière-plan. Ghostty, Terminal.app, iTerm2 et autres.
L’usage Claude n’est plus compté en double, les sous-agents et les appels à un modèle conseiller sont inclus, le coût Grok vient du coût par tour fourni par Grok, et un modèle sans prix connu est signalé au lieu d’afficher 0 $. Les coûts restent une estimation équivalent-API, pas le prix de votre abonnement.
Elle réagit, dans votre barre de menus
RUN La fleet tourne, tout est vert.
Trois thèmes, clair/sombre automatique
Aussi sur votre Stream Deck
La même chose sur du matériel : une petite créature pixel vit sur une touche et réagit à votre fleet en temps réel, entourée de tuiles live.
RUN La fleet tourne, tout en un coup d’œil.
Le companion réagit
une session tourne
une session vous attend
travail livré
tout est calme
Les 13 tuiles
Votre familier pixel réactif, 12 skins.
Le compte live de chaque session en une tuile : RUN, INPUT, END.
Combien de sessions dans un état donné : RUN, INPUT ou END.
Une session précise : son titre, son % de contexte, ses tokens entrants et sortants, ses lectures de cache ou son coût, avec un ↻ si elle tourne en /loop.
Combien de sessions tournent un /loop, avec le compte à rebours du prochain run.
Streak et heatmap sur 12 semaines.
Usage de tokens par heure, votre pic.
Aujourd’hui, lifetime, ou sparkline 24 h. Tokens facturés par défaut, lectures de cache à part.
Dépense équivalent-API, du jour au lifetime. Un ! signale un modèle sans prix connu.
Dépense par projet et par modèle.
Tokens par minute sur la dernière heure.
Compteur jour/semaine : permissions, runs, sous-agents, loops lancés ou itérations.
Un récap partageable de vos stats.
Local-first & vie privée
Code Critter est conçu pour être d’un ennui rassurant avec vos données.
- ›Lit vos fichiers Claude Code locaux sous ~/.claude et ceux de Grok, en lecture seule.
- ›Aucun appel réseau, aucune API. Ni compte, ni clé.
- ›Aucune télémétrie. Rien n’est collecté, stocké à distance, ni partagé.
- ›Les coûts sont une estimation équivalent-API, pas une facture, et ne quittent jamais votre machine.
Installation
Installez l’app de bureau (macOS, Windows ou Linux), ou le plugin Stream Deck (voir Téléchargements) puis glissez n’importe quelle tuile sur une touche. Tokens, coût, coût projet et activité fonctionnent immédiatement.
Sessions live : pourquoi un hook
Certaines tuiles ont besoin de savoir si une session travaille, attend, ou a fini : un état que Claude Code et Grok ne stockent nulle part. Un petit hook le capte.
-
Sans rien
Tokens, coût, coût projet et activité marchent déjà : Claude Code et Grok écrivent leurs transcripts.
-
Ce qui manque
L’état live (
working,waiting,done) n’existe dans aucun fichier. -
Le hook
Un plugin écoute les événements de Claude Code ou de Grok et écrit l’état dans
~/.claude/deck-stateou~/.grok/deck-state, lu par l’app.
La détection de /loop ne demande aucun réglage : la tuile Session affiche un ↻, la tuile Loops compte les boucles actives, et tout est lu directement dans le transcript, toujours 100 % local.
L’app de bureau installe les hooks elle-même, pour Claude Code et Grok : rien à faire ici. Sans elle, dans Claude Code, activer le plugin les installe automatiquement :
Une commande à la fois : copiez, collez, validez, puis la suivante.
- 1
/plugin marketplace add https://github.com/denisvinciguerra/code-critter-hooks - 2
/plugin install code-critter@code-critter - 3
/reload-plugins
Pour Grok, dans un terminal (même sans le plugin Claude Code), puis ouvrez une nouvelle session Grok :
- 1
grok plugin marketplace add https://github.com/denisvinciguerra/code-critter-hooks - 2
grok plugin install code-critter --trust
FAQ
Faut-il une clé API Claude ou Anthropic ? +
Non. Code Critter lit seulement les fichiers que Claude Code écrit déjà sur votre machine. Aucun appel API, aucune clé à saisir.
Le coût affiché est-il ma vraie facture ? +
Non. Sur un abonnement forfaitaire il n’y a pas de facture au token : la tuile coût montre une estimation équivalent-API, étiquetée comme telle.
Une tuile affiche un tiret ou zéro. +
Il n’y a pas encore de données locales pour cette métrique. La tuile se remplit au fil de votre usage de Claude Code.
Le companion dort toujours, ou mes tuiles Fleet/Session sont vides. +
Ces tuiles live ont besoin des hooks optionnels pour Claude Code ou Grok : l’app de bureau les installe, sinon voir Installation. Tokens, coût et activité fonctionnent sans eux.
Téléchargements
Le dépôt GitHub est privé pour l’instant, il s’ouvre bientôt.