Skip to content

cost-guard report

Show local session usage stats in terminal.

Usage

cost-guard report [OPTIONS]

Options

Option Default Description
--project PATH . Project path to scan
--since YYYY-MM-DD Only include sessions since this date
--last N 20 Show only last N sessions
--all Show all sessions (ignores --last)

Examples

Show last 20 sessions:

cost-guard report

Show sessions from last 7 days:

cost-guard report --since 2026-05-17

Show all sessions:

cost-guard report --all

Show sessions from a different project:

cost-guard report --project ../other-project

Output

Terminal table with columns:

  • Date — session date
  • Model — Claude Opus / Sonnet / Haiku
  • Tokens — input + output tokens
  • Cost — USD estimated cost
  • Project — project name