Skip to content
llm-usage-metrics

Getting Started

Install

Section titled “Install”
Terminal window
npm install -g llm-usage-metrics

Run without global install:

Terminal window
npx --yes llm-usage-metrics daily

Requirements

Section titled “Requirements”
  • Node.js 24+
  • At least one supported source:
    • .pi sessions (~/.pi/agent/sessions/**/*.jsonl)
    • .codex sessions (~/.codex/sessions/**/*.jsonl)
    • OpenCode SQLite DB (auto-discovered or explicit --opencode-db)

First report

Section titled “First report”
Terminal window
llm-usage daily

Useful next commands:

Terminal window
llm-usage weekly --timezone Europe/Paris
llm-usage monthly --since 2026-01-01 --until 2026-01-31

Common filters

Section titled “Common filters”
Terminal window
llm-usage monthly --source pi,codex
llm-usage monthly --provider openai
llm-usage monthly --model claude

Output modes

Section titled “Output modes”
Terminal window
llm-usage daily --json
llm-usage daily --markdown
llm-usage monthly --per-model-columns

OpenCode explicit DB path

Section titled “OpenCode explicit DB path”
Terminal window
llm-usage monthly --source opencode --opencode-db /path/to/opencode.db

If no default OpenCode DB is found and no explicit path is given, OpenCode is treated as unavailable for that run.