llm-usage-metrics 0.1.5 → 0.1.6

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
@@ -131,7 +131,40 @@ llm-usage monthly --source pi --source codex
131
131
  llm-usage monthly --source pi,codex
132
132
  ```
133
133
 
134
- ## Output semantics
134
+ ## Output features
135
+
136
+ ### Terminal UI
137
+
138
+ The CLI provides an enhanced terminal output with:
139
+
140
+ - **Boxed report header** showing the report type and timezone
141
+ - **Session summary** displayed at startup (session files and event counts per source)
142
+ - **Pricing source info** indicating whether data was loaded from cache or fetched remotely
143
+ - **Environment variable overrides** displayed when active
144
+ - **Models displayed as bullet points** for better readability
145
+ - **Rounded table borders** and improved color scheme
146
+
147
+ Example output:
148
+
149
+ ```text
150
+ ℹ Found 12 session file(s) with 45 event(s)
151
+ • pi: 8 file(s), 32 events
152
+ • codex: 4 file(s), 13 events
153
+ ℹ Loaded pricing from cache
154
+
155
+ ┌──────────────────────────────────────────────────────────┐
156
+ │ Monthly Token Usage Report (Timezone: Africa/Casablanca) │
157
+ └──────────────────────────────────────────────────────────┘
158
+
159
+ ╭────────────┬──────────┬──────────────────────╮
160
+ │ Period │ Source │ Models │
161
+ ├────────────┼──────────┼──────────────────────┤
162
+ │ Feb 2026 │ pi │ • gpt-5.2 │
163
+ │ │ │ • gpt-5.2-codex │
164
+ ╰────────────┴──────────┴──────────────────────╯
165
+ ```
166
+
167
+ ### Report structure
135
168
 
136
169
  Each report includes:
137
170
 
@@ -149,8 +182,8 @@ Columns:
149
182
  - Reasoning
150
183
  - Cache Read
151
184
  - Cache Write
152
- - Total Tokens
153
- - Cost (USD)
185
+ - Total
186
+ - Cost
154
187
 
155
188
  ## Development
156
189