Configuration

llm-usage-metrics is configured through CLI flags and environment variables.

Path overrides

Directory-backed sources:

llm-usage daily --pi-dir /path/to/pi --codex-dir /path/to/codex

Generic directory override syntax:

llm-usage daily --source-dir pi=/path/to/pi --source-dir codex=/path/to/codex

OpenCode uses a dedicated DB override flag:

llm-usage daily --opencode-db /path/to/opencode.db

Notes:

• --source-dir is directory-only (pi, codex).
• --source-dir opencode=... is rejected; use --opencode-db.
• OpenCode path precedence is:
  1. --opencode-db
  2. deterministic OS-specific default DB candidates

Source selection

llm-usage monthly --source pi
llm-usage monthly --source pi,codex
llm-usage monthly --source opencode --opencode-db /path/to/opencode.db

Runtime environment variables

Update notifier and parsing/pricing runtime knobs (see Caching for behavior details):

• LLM_USAGE_SKIP_UPDATE_CHECK
• LLM_USAGE_UPDATE_CACHE_SCOPE
• LLM_USAGE_UPDATE_CACHE_SESSION_KEY
• LLM_USAGE_UPDATE_CACHE_TTL_MS
• LLM_USAGE_UPDATE_FETCH_TIMEOUT_MS
• LLM_USAGE_PRICING_CACHE_TTL_MS
• LLM_USAGE_PRICING_FETCH_TIMEOUT_MS
• LLM_USAGE_PARSE_MAX_PARALLEL
• LLM_USAGE_PARSE_CACHE_ENABLED
• LLM_USAGE_PARSE_CACHE_TTL_MS
• LLM_USAGE_PARSE_CACHE_MAX_ENTRIES
• LLM_USAGE_PARSE_CACHE_MAX_BYTES

Example:

LLM_USAGE_PARSE_MAX_PARALLEL=16 LLM_USAGE_PRICING_FETCH_TIMEOUT_MS=8000 llm-usage monthly