agentic-code-metrics

Dashboard de métriques pour mesurer l'efficacité de tes sessions LLM (Claude Code pour l'instant). Lit tes données locales, les stocke dans une base SQLite, et génère un dashboard HTML statique avec des graphes d'évolution.

Local-first, zéro backend. Tes données ne quittent jamais ta machine.

Installation rapide

Aucune installation nécessaire — via npx :

# 1. Initialise la base + enregistre les hooks Claude Code
npx agentic-code-metrics setup

# 2. Rattrape ton historique existant (~/.claude → base locale)
npx agentic-code-metrics backfill

# 3. Génère le dashboard
npx agentic-code-metrics render

Le dashboard est écrit dans ./output/dashboard.html — ouvre-le dans ton navigateur.

Commandes

| Commande | Description | |---|---| | setup | Initialise la base et enregistre les hooks Claude Code (capture live des sessions) | | backfill | Importe l'historique des sessions (~/.claude) dans la base | | render | Génère output/dashboard.html depuis la base (commande par défaut) | | ingest | (interne) Appelé par le hook SessionEnd — ingère une session depuis stdin | | event <type> | (interne) Appelé par le hook PostToolUse — enregistre un événement |

Options de render

npx agentic-code-metrics render --project <nom>        # Filtre par projet
npx agentic-code-metrics render --experiments <path>   # YAML d'expérimentations custom
npx agentic-code-metrics render --output <dir>         # Dossier de sortie

Options de backfill

npx agentic-code-metrics backfill --source <nom>   # Source à rattraper (défaut: claude)
npx agentic-code-metrics backfill --project <nom>  # Filtre par projet

Comment ça marche

~/.claude  ──(backfill)─────┐
                            ├─► base SQLite ──► render ──► dashboard.html
hook SessionEnd ─(ingest)───┘
   (backfill = historique ; hook = live)

• Backfill : rattrape les sessions passées en une fois.
• Hooks : capturent les sessions au fil de l'eau (installés par setup).

La base vit dans ~/.agentic-code-metrics/metrics.db. La variable d'environnement CCM_DB_PATH permet de pointer une base alternative.

Prérequis

• Node.js ≥ 20

Licence

MIT © Jeremy Chauvin