CodeBurn : un outil local de suivi des tokens et coûts pour les outils de codage IA

Un suiveur local-first pour les dépenses de codage IA · codeburn

CodeBurn est un outil gratuit, open source et local-first qui suit l'utilisation des tokens et les coûts de codage IA sur 36 outils et agents, dont Claude Code, Cursor, Codex, Gemini, Grok et autres. Il lit les fichiers de session que ces outils écrivent déjà sur le disque et décompose chaque token et dollar par tâche, modèle, outil et projet. Pas de wrapper, pas de proxy, pas de clés API, et rien ne quitte votre machine. Les prix proviennent de LiteLLM, actualisés quotidiennement. Le README montre quatre surfaces : un tableau de bord terminal, un tableau de bord web, une application de barre de menus macOS et une application desktop, avec l'affirmation que tout lit les mêmes fichiers de session déjà présents sur le disque.

Démarrage rapide et surfaces de commande · codeburn

Le moyen le plus rapide d'exécuter CodeBurn est `npx codeburn`, qui ouvre par défaut un tableau de bord interactif pour les sept derniers jours. Les touches fléchées changent de période et `q` quitte. Pour une commande permanente, `npm install -g codeburn` l'installe globalement ; `bunx codeburn` et `pnpm dlx codeburn` fonctionnent aussi, et sur macOS, `brew install codeburn` est une option. Node.js 22.13+ est requis, ainsi qu'au moins un outil pris en charge avec des données de session sur disque. L'application de barre de menus pour macOS se lance avec `codeburn menubar`, et une extension GNOME Shell fournit une vue de panneau similaire sous Linux. Le README liste également une application desktop avec des téléchargements pour macOS, Windows et Linux, mais les étapes de configuration exactes pour la version desktop ne sont pas décrites au-delà des liens de téléchargement.

Optimiser et agir : trouver et corriger les gaspillages · codeburn

La commande `codeburn optimize` analyse les sessions et la configuration `~/.claude/` pour détecter des modèles de gaspillage : fichiers relus entre sessions, faible ratio lecture/édition, sortie bash non limitée, serveurs MCP inutilisés, agents et compétences fantômes, fichiers `CLAUDE.md` gonflés, surcoût de création de cache, sessions lourdes en contexte et sessions coûteuses sans édition ni tentative. Chaque constat inclut une économie estimée en tokens et en dollars et un correctif prêt à coller, classé par urgence avec une note de santé de configuration de A à F. Les exécutions répétées classent les constats comme nouveaux, en amélioration ou résolus sur une fenêtre de 48 heures. Le drapeau `--apply` applique les correctifs de configuration de manière interactive, avec `--dry-run` pour prévisualiser et `--yes` pour tout appliquer. Chaque modification est sauvegardée et journalisée avant d'être appliquée, et `codeburn act list`, `codeburn act undo` et `codeburn act report` suivent l'historique, annulent les modifications et comparent les économies réalisées aux estimations après trois jours.

Garde-fous budgétaires pour Claude Code · codeburn

CodeBurn peut installer des hooks opt-in dans Claude Code qui surveillent le coût de session pendant que vous travaillez. `codeburn guard install` ajoute ces hooks au `.claude/settings.json` d'un projet ou globalement à `~/.claude/settings.json`. Il y a un plafond souple (défaut 5 $) qui affiche un avertissement unique, un plafond dur (défaut 15 $) qui arrête la session, `codeburn guard allow` le levant uniquement pour cette session, et un point de contrôle (défaut 3 $) qui vous incite à repartir de zéro si une session se termine sans édition ni commit. Les plafonds sont modifiés dans `~/.config/codeburn/guard.json`, et `--statusline` affiche le coût de session dans la ligne d'état de Claude Code. Les installations passent par le même journal que les autres modifications, donc `codeburn act undo` les supprime aussi. Les hooks sont fail-open, donc un garde défectueux ne bloque jamais une session.

Comparer les modèles et suivre le travail livré · codeburn

`codeburn compare` ouvre un sélecteur de modèles interactif qui compare les modèles sur le taux de réussite en un coup, le taux de nouvelle tentative, l'auto-correction, le coût par appel, le coût par édition, les tokens de sortie par appel et le taux de hit cache, ainsi que les taux de réussite en un coup par catégorie, le taux de délégation, le taux de planification, le nombre moyen d'outils par tour et l'utilisation du mode rapide. `codeburn yield` corrèle les sessions IA avec les commits git par horodatage et catégorise les dépenses comme productives, annulées, abandonnées ou ambiguës. L'attribution est heuristique : chaque commit est crédité à au plus une session, la fenêtre la plus étroite le contenant, et le rapport JSON porte `methodology: "timestamp-window"`. Yield nécessite un dépôt git et se lance depuis le répertoire du projet.

Tableau de bord web, barre de menus, MCP et partage d'appareils · codeburn

`codeburn web` démarre un tableau de bord navigateur local sur http://localhost:4747 avec les mêmes décompositions que l'interface terminal, plus des graphiques. Le serveur se lie à localhost et rien n'est téléversé. `codeburn menubar` télécharge et installe une application native de barre de menus macOS qui affiche les dépenses dans la barre de menus, avec sélection de période, mode compact et cadence d'actualisation configurable. Le README décrit également une extension GNOME Linux pour le même usage. `codeburn mcp` exécute un serveur MCP local sur stdio exposant les outils `get_usage` et `get_savings`, avec des noms de projets pseudonymisés par défaut. Pour combiner l'utilisation sur plusieurs appareils, `codeburn share --pair` imprime un PIN pour l'appairage, et `codeburn devices` affiche les totaux combinés. Une commande d'aperçu `codeburn sync` pousse l'utilisation vers un point de terminaison distant pour la télémétrie d'équipe, envoyant les compteurs de tokens, les coûts, les modèles et les projets, mais jamais les invites ou le code ; le protocole peut changer entre les versions.

Comment il lit les données et ce qu'il suit · codeburn

CodeBurn lit les fichiers de session et les bases de données de chaque outil pris en charge. Pour Claude Code, il lit `~/.claude/projects/<sanitized-path>/<session-id>.jsonl` ; pour Codex, il lit les fichiers JSONL sous `~/.codex/sessions/` ; Cursor utilise une base SQLite `state.vscdb` ; OpenCode utilise SQLite ou un stockage basé sur fichiers ; Gemini CLI écrit un fichier JSON par session ; et de nombreux autres fournisseurs ont leurs propres chemins documentés. Pour certains fournisseurs, les compteurs de tokens sont estimés à partir de la longueur du contenu ou d'autres heuristiques, et le README marque ces chiffres comme estimés. Les prix sont récupérés de LiteLLM et mis en cache localement pendant 24 heures, avec des replis codés en dur pour les modèles Claude et GPT-5. CodeBurn suit également 13 catégories de tâches déterministes, un taux de réussite en un coup basé sur les cycles de nouvelle tentative conscients des fichiers, les plans, la conversion de devises, les alias de modèles, les surcharges de prix et les économies de modèles locaux. `codeburn doctor` diagnostique la détection des fournisseurs hors ligne et en lecture seule, et une sortie JSON est disponible pour les rapports.

Conclusion éditoriale

CodeBurn est sous licence MIT et lit les fichiers de session locaux pour produire une décomposition des dépenses de codage IA. Il fournit un tableau de bord terminal, un tableau de bord web, une application de barre de menus macOS et des builds desktop, ainsi que des commandes pour l'analyse des gaspillages, les garde-fous budgétaires, la comparaison de modèles et le suivi du rendement basé sur git. Le README ne décrit aucun benchmark de performance spécifique ni résultat de production.

Sources officielles

1. Official documentation
2. Official README
3. Project repository
4. Release notes