llm-usage-metrics 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Abdeslam Yassine Agmar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,103 @@
+# llm-usage-metrics
+
+CLI to aggregate local LLM usage from:
+
+- `~/.pi/agent/sessions/**/*.jsonl`
+- `~/.codex/sessions/**/*.jsonl`
+
+Reports are available for daily, weekly (Monday-start), and monthly periods.
+
+Project documentation is available in [`docs/`](./docs/README.md).
+
+## Install
+
+```bash
+npm install -g llm-usage-metrics
+```
+
+Or run without global install:
+
+```bash
+npx llm-usage-metrics daily
+```
+
+## Usage
+
+### Daily report (default terminal table)
+
+```bash
+usage daily
+```
+
+### Weekly report with custom timezone
+
+```bash
+usage weekly --timezone Europe/Paris
+```
+
+### Monthly report with date range
+
+```bash
+usage monthly --since 2026-01-01 --until 2026-01-31
+```
+
+### Markdown output
+
+```bash
+usage daily --markdown
+```
+
+### JSON output
+
+```bash
+usage daily --json
+```
+
+### Offline pricing (use cached LiteLLM pricing only)
+
+```bash
+usage monthly --pricing-offline
+```
+
+### Override pricing URL
+
+```bash
+usage monthly --pricing-url https://raw.githubusercontent.com/BerriAI/litellm/main/model_prices_and_context_window.json
+```
+
+### Custom session directories
+
+```bash
+usage daily --pi-dir /path/to/pi/sessions --codex-dir /path/to/codex/sessions
+```
+
+## Output semantics
+
+Each report includes:
+
+- source rows (`pi`, `codex`) for each period
+- a per-period combined subtotal row (only when multiple sources exist in that period)
+- a final grand total row across all periods
+
+Columns:
+
+- Period
+- Source
+- Models
+- Input
+- Output
+- Reasoning
+- Cache Read
+- Cache Write
+- Total Tokens
+- Cost (USD)
+
+## Development
+
+```bash
+bun install
+bun run lint
+bun run typecheck
+bun run test
+bun run format:check
+```

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node