Global Options
These options are available across all commands (daily, monthly, session, blocks, statusline).Output Format
Output results in JSON format instead of formatted tables.
Process JSON output with jq command. Automatically implies
--json. Requires jq binary to be installed.The jq binary must be available in your PATH for this option to work.
Display Options
Enable colored output. Defaults to auto-detection based on terminal capabilities.
You can also set
FORCE_COLOR=1 environment variable to enable colors.Disable colored output. Overrides auto-detection and color settings.
You can also set
NO_COLOR=1 environment variable to disable colors.Force compact mode for narrow displays. Better for screenshots and constrained terminal widths.
Date Filtering
Filter from date in YYYYMMDD format. Limits results to data from this date onwards.
Filter until date in YYYYMMDD format. Limits results to data up to and including this date.
Both
--since and --until can be combined to create a date range.Cost Calculation
Control cost calculation mode:
auto- Use pre-calculated costUSD when available, otherwise calculate from tokenscalculate- Always calculate costs from token counts using model pricing, ignore costUSDdisplay- Always use pre-calculated costUSD values, show 0 for missing costs
The
calculate mode is useful for verifying pricing consistency or when costUSD is missing.Use cached pricing data for Claude models instead of fetching from LiteLLM API.
Offline mode uses cached pricing data and doesn’t require internet access.
Sorting
Sort order for results:
asc- Oldest first (chronological order)desc- Newest first (reverse chronological order)
Model Breakdown
Show per-model cost breakdown in the output. Displays token counts and costs for each Claude model used.
Localization
Timezone for date grouping (e.g., UTC, America/New_York, Asia/Tokyo). Defaults to system timezone.
Valid timezone names follow the IANA Time Zone Database format.
Locale for date/time formatting (e.g., en-US, ja-JP, de-DE).
Configuration
Path to configuration file. Defaults to auto-discovery from standard locations.
See Config Files for configuration file format and options.
Debugging
Show pricing mismatch information for debugging. Displays discrepancies between calculated and pre-calculated costs.
Number of sample discrepancies to show in debug output. Only used when
--debug is enabled.