Data Sources

llm-usage-metrics supports five built-in sources:

• pi
• codex
• gemini
• droid
• opencode

Each source is parsed by a dedicated adapter and normalized into the same UsageEvent schema before pricing/aggregation.

Discovery model

• pi and codex: recursive JSONL discovery in their session directories
• gemini: JSON session discovery under ~/.gemini/tmp/*/chats/*.json (or --gemini-dir)
• droid: session settings discovery under ~/.factory/sessions/**/*.settings.json (or --droid-dir)
• opencode: single SQLite DB (auto-discovered or explicit --opencode-db)

Source filtering

llm-usage monthly --source pi
llm-usage monthly --source pi,codex,gemini,droid
llm-usage monthly --source gemini --gemini-dir /path/to/.gemini
llm-usage monthly --source droid --droid-dir /path/to/.factory/sessions
llm-usage monthly --source opencode --opencode-db /path/to/opencode.db

See per-source pages for details.