TOKSCALE : Un outil CLI pour suivre l’utilisation de tokens

https://github.com/junhoyeo/tokscale

📌 TOKSCALE est une application en ligne de commande (CLI) pensé pour suivre la consommation de tokens et estimer les coûts liés à l’usage des assistants de code IA, sur plusieurs plateformes. Tokscale agrège les données de sessions locales (et, pour certains outils, via synchronisation API) afin de transformer des historiques dispersés en statistiques exploitables : volumes de tokens, coûts estimés, modèles les plus utilisés, et activité jour par jour.

Le suivi couvre notamment OpenCode, Claude Code, Codex CLI, Gemini CLI, Cursor IDE, Amp (AmpCode) et Droid (Factory Droid), avec des emplacements de données standards (ex. dossiers de sessions) et une prise en charge déclarée comme complète sur ces clients.

Au milieu de cet ensemble, Tokscale met l’accent sur des usages concrets :

• 🧭 Vue “Overview” : synthèse rapide (tendance, top modèles, coûts estimés)
• 🧠 Vue “Models” : classement des modèles et détail des dépenses/tokens
• 📅 Vue “Daily/Monthly” : répartition temporelle, filtres par période
• 📊 Vue “Stats” : graphe de contributions style GitHub, métriques d’activité
• ⚡ Moteur natif : parsing/agrégation accélérés via un cœur Rust annoncé ~10x plus rapide
• 💸 Pricing temps réel : calcul des prix via les données LiteLLM, avec cache disque et prise en compte de tokens “cache” et modèles à tarification par paliers
• 🧰 Export JSON : génération de données pour automatisation et visualisations externes
• 🏆 Social & leaderboard : profil public, soumission des stats, comparaison communautaire

L’interface principale peut fonctionner en mode TUI interactif (terminal UI) avec navigation clavier/souris, filtres (plateforme, dates, année), tri par coût/tokens, et rendu “zéro scintillement” via un moteur natif (OpenTUI/Zig côté rendu annoncé).

Pour une lecture plus visuelle, Tokscale propose aussi un frontend avec calendrier de contributions en 2D et une vue 3D isométrique où la “hauteur” reflète l’intensité d’usage, plus un panneau de détail au jour le jour (sources et modèles), et des indicateurs comme jours actifs, streaks, total tokens et coût.

Côté démarrage, l’approche est volontairement directe : exécution via Bun (bunx) pour lancer l’outil immédiatement, et un mode “light” possible pour afficher des tableaux sans TUI.

Tokscale intègre également une idée “Wrapped 2025” inspirée des bilans annuels, avec génération d’une image récapitulative (tokens totaux, top modèles, top clients, messages, jours actifs, coût estimé, meilleure série, heatmap d’activité), optimisée pour le partage.

Enfin, la dimension “échelle” est revendiquée : Tokscale s’inspire de la Kardashev scale (mesure de consommation d’énergie) en transposant l’idée aux tokens, présentés comme l’“énergie” des usages IA, afin de visualiser la progression d’un usage occasionnel vers un usage intensif et structuré.