From 69077f63b2dc021e18e4f9a1b604ebf37bc7bfc3 Mon Sep 17 00:00:00 2001 From: Vijay Date: Fri, 9 Oct 2026 23:07:05 -0400 Subject: [PATCH] docs: lead with the token spike question Signed-off-by: Vijay --- README.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 820eb24..9ad5957 100644 --- a/README.md +++ b/README.md @@ -2,10 +2,12 @@ [![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/llm-measurement/fleetdiff/badge)](https://scorecard.dev/viewer/?uri=github.com/llm-measurement/fleetdiff) -fleetdiff is a command-line tool that compares summary files from LLM and agent -traffic and reports what changed between two time windows: whether token use rose -from more requests or larger ones, which users or sessions drove the change, and -whether usage data is complete. It reads summaries exported by the +**Why did LLM token usage spike, and which users or sessions drove the change?** + +fleetdiff is a local command-line tool that compares LLM usage summaries, +flags unusual windows, and checks trace captures and collector configurations. + +It reads summaries exported by the [otelcol-genai-sketches](https://github.com/llm-measurement/otelcol-genai-sketches) collector or any [llm-sketchkit](https://github.com/llm-measurement/llm-sketchkit) producer. It runs locally and only reads files: no account, upload or model API key.