OPENCODE-USAGE : savoir combien coûte votre agent de code
https://github.com/gaboe/opencode-usage
📌 opencode-usage est un CLI qui lit la base SQLite d’OpenCode pour afficher les tokens consommés et le coût estimé par jour, par mois et par fournisseur. Un tableau de bord web, Commander, complète le terminal.
Quand on utilise un assistant de code comme OpenCode avec plusieurs fournisseurs — Anthropic, OpenAI, Google — la question revient vite : combien ai-je consommé ce mois-ci ? Les dashboards officiels donnent des données par compte, mais aucun ne croise tous les fournisseurs dans une seule vue. opencode-usage comble ce manque.
L’outil s’installe sans friction : bunx opencode-usage ou npx opencode-usage suffisent. Il lit directement la base SQLite que maintient OpenCode (~/.local/share/opencode/opencode.db), aggrège les tokens par jour et applique les tarifs API actuels pour calculer un coût. Le résultat s’affiche en table dans le terminal, ou en JSON pour l’automatisation.
La ligne de commande offre des filtres pratiques : par fournisseur (--provider anthropic), par plage de dates (--since 7d, --since 2025-12-01), par agrégation mensuelle (--monthly). Le mode watch rafraîchit les données toutes les cinq secondes — utile pour surveiller une session longue. La sortie JSON permet de chaîner avec jq ou un script CI.
Le Commander, lancé avec --commander, ouvre une interface web single-page. On y trouve le statut des quotas par compte avec barres de progression, la gestion multi-comptes pour Anthropic et Gemini, un tableau d’utilisation jour/mois avec filtre fournisseur, et un ping de connectivité. Le système de plugins permet d’étendre les fournisseurs. L’interface se rafraîchit automatiquement toutes les cinq minutes.
Un point important à retenir : si vous utilisez OpenCode avec un abonnement Claude Max ou des crédits Zen, le coût affiché est l’équivalent API, pas votre dépense réelle. L’outil le précise, et c’est une nuance appréciable — la colonne « Cost » sert de référence, pas de facture.
Le projet est en TypeScript, MIT, avec 21 releases et 60 commits. Gaboe maintient un rythme d’itération régulier, et les 13 étoiles reflètent une niche réelle mais engagée. Pour qui gère plusieurs clés API ou surveille un budget d’inférence, c’est devenu un réflexe quotidien.
