llm-usage-metrics 0.4.3 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -30,6 +30,7 @@ Aggregate token usage and costs from your local coding agent sessions. Supports
30
30
  - **Flexible Reports** — Daily, weekly, and monthly aggregations
31
31
  - **Efficiency Reports** — Correlate cost/tokens with repository commit outcomes
32
32
  - **Optimize Reports** — Counterfactual candidate-model pricing against observed token mix
33
+ - **Trends Reports** — Daily cost or token trend views with combined or per-source output
33
34
  - **Multiple Outputs** — Terminal tables, JSON, or Markdown
34
35
  - **Smart Filtering** — By source, billing provider, model, and date ranges
35
36
 
@@ -97,6 +98,21 @@ llm-usage monthly --per-model-columns
97
98
  llm-usage monthly --share
98
99
  ```
99
100
 
101
+ ### Trends
102
+
103
+ ```bash
104
+ # Last 30 local days of cost by default
105
+ llm-usage trends
106
+
107
+ # Token trends for the last 7 days
108
+ llm-usage trends --metric tokens --days 7
109
+
110
+ # Per-source trends in JSON
111
+ llm-usage trends --by-source --json
112
+ ```
113
+
114
+ Trends is terminal-first and supports `--json`. It does not support `--markdown` or `--share`.
115
+
100
116
  ### Efficiency Reports
101
117
 
102
118
  ```bash