summary

One-screen dashboard of your Claude Code usage. This is the command you run first.

Usage

claudex summary [--json] [--no-index] [--plan <api|flat-monthly:USD>]

What it shows

• Sessions — total, today, this week.
• Cost (estimated) — all time, this week.
• Tokens — sum of input, output, cache-write, cache-read.
• Thinking — number of extended-thinking blocks.
• Turns — average turn duration in milliseconds.
• PRs — count of sessions linked to pull requests.
• Files — total distinct files modified across all sessions.
• Top projects — up to 5 by session count.
• Top tools — up to 5 by call count (Bash, Edit, Read, etc).
• Top stop reasons — up to 5 by assistant stop reason.
• Model distribution — sessions and cost per model family.
• Most recent session — project, session ID, timestamp, model, message count.

Flags

Flag	Description
--json	Emit JSON (see shape below).
--no-index	Scan JSONL files directly; don't touch the index.
--plan <api|flat-monthly:USD>	Cost-reporting mode. api (default) prices tokens at API rates. flat-monthly:250 reframes for a flat subscription.

Example

claudex summary

claudex summary --json | jq '.total_cost_usd'

# Pro Max user: how much value am I extracting from a $250/mo plan?
claudex summary --plan flat-monthly:250
claudex summary --plan flat-monthly:250 --json | jq '.leverage_this_week_multiple'

JSON shape (default — --plan api)

{
  "total_sessions": 372,
  "sessions_today": 4,
  "sessions_this_week": 28,
  "total_cost_usd": 512.34,
  "cost_this_week_usd": 41.22,
  "total_input_tokens": 93847123,
  "total_output_tokens": 18123456,
  "total_cache_creation_tokens": 301122,
  "total_cache_read_tokens": 5512201,
  "total_tokens": 116784902,
  "thinking_block_count": 1289,
  "avg_turn_duration_ms": 4132,
  "pr_count": 14,
  "files_modified_count": 842,
  "top_projects": [{ "project": "claudex", "sessions": 41 }],
  "top_tools": [{ "tool": "Edit", "calls": 1240 }],
  "top_stop_reasons": [{ "stop_reason": "end_turn", "count": 812 }],
  "model_distribution": [
    { "model": "claude-opus-4-7", "sessions": 12, "cost_usd": 210.44 }
  ],
  "most_recent": {
    "project": "claudex",
    "session_id": "e1a2f4...",
    "date": "2026-04-18T14:22:13+00:00",
    "model": "claude-sonnet-4-6",
    "message_count": 83
  }
}

JSON shape (--plan flat-monthly:USD)

The flat-monthly mode is additive. The historical total_cost_usd and cost_this_week_usd keys are still present (so existing pipelines keep working), and the following keys are added:

{
  "...": "all default fields above are also present",
  "total_cost_usd": 18188.4,
  "cost_this_week_usd": 3136.21,
  "plan": "flat-monthly",
  "actual_monthly_cost_usd": 250.0,
  "api_equivalent_total_usd": 18188.4,
  "api_equivalent_week_usd": 3136.21,
  "leverage_this_week_multiple": 54.54
}

Key	Meaning
plan	Discriminator — "flat-monthly" when set; absent under --plan api.
actual_monthly_cost_usd	The flat fee passed in, e.g. 250.0 for flat-monthly:250.
api_equivalent_total_usd	Lifetime API-rate value of all sessions. Equal to total_cost_usd.
api_equivalent_week_usd	This week's API-rate value. Equal to cost_this_week_usd.
leverage_this_week_multiple	api_equivalent_week_usd ÷ (actual_monthly_cost_usd ÷ 4.348) — this week's value vs. a week's worth of plan cost. Emitted as null when api_equivalent_week_usd == 0 (a brand-new account would otherwise show a misleading "0× leverage").

Notes

• Week boundary. "This week" starts Monday 00:00 in the local time zone.
• Cost is approximate. See Pricing model.
• Missing most_recent. If ~/.claude/projects/ is empty, most_recent is null.
• Plan-relative leverage is this-week, not lifetime. 4.348 is the calendar-accurate weeks-per-month constant (365.25 / 12 / 7). A lifetime leverage figure would conflate accounts of different ages and is intentionally not emitted; consumers can derive their own with the api_equivalent_total_usd / actual_monthly_cost_usd pair plus their own months-on-plan count.
• --plan only affects the cost section. Sessions, tokens, top projects/tools, model distribution, and turn metrics are unchanged.