Command	Description
`npx ccusage@latest daily`	Usage by date (default)
`npx ccusage@latest monthly`	Usage by month
`npx ccusage@latest weekly`	Usage by week
`npx ccusage@latest session`	Usage by conversation session
`npx ccusage@latest blocks`	Usage by billing blocks (5-hour windows)
`npx ccusage@latest statusline`	Compact status for hooks

Common Filters

# Date range
npx ccusage@latest daily --json --offline --since 20260301 --until 20260311

# Specific project
npx ccusage@latest daily --json --offline --project "my-project"

# Model breakdown
npx ccusage@latest daily --json --offline --breakdown

# Instance breakdown
npx ccusage@latest daily --json --offline --instances

JSON Output Structure

Daily/Monthly/Weekly

{
  "daily": [{
    "date": "2026-03-11",
    "inputTokens": 1000,
    "outputTokens": 500,
    "cacheCreationTokens": 2000,
    "cacheReadTokens": 5000,
    "totalTokens": 8500,
    "totalCost": 0.05,
    "modelsUsed": ["claude-sonnet-4-6"],
    "modelBreakdowns": [...]
  }]
}

Session

{
  "sessions": [{
    "sessionId": "-path-to-project",
    "inputTokens": 1000,
    "outputTokens": 500,
    "totalCost": 0.05,
    "lastActivity": "2026-03-11",
    "modelsUsed": [...],
    "projectPath": "project-name"
  }]
}

Blocks

{
  "blocks": [{
    "id": "2026-03-11T08:00:00.000Z",
    "startTime": "...",
    "endTime": "...",
    "isActive": false,
    "totalTokens": 8500,
    "costUSD": 0.05,
    "models": [...]
  }]
}

Common Queries

Today's usage:

npx ccusage@latest daily --json --offline --since $(date +%Y%m%d)

This month:

npx ccusage@latest monthly --json --offline --since $(date +%Y%m01)

Cost by model:

npx ccusage@latest daily --json --offline --breakdown

Most active sessions:

npx ccusage@latest session --json --offline --order desc

Key Options

Option	Description
`-s, --since`	Start date (YYYYMMDD)
`-u, --until`	End date (YYYYMMDD)
`-p, --project`	Filter by project name
`-b, --breakdown`	Show per-model costs
`-i, --instances`	Show project breakdown
`-o, --order`	Sort: `asc` or `desc`
`-z, --timezone`	Timezone for grouping
`-O, --offline`	Use cached pricing
`-j, --json`	JSON output

ccusage

CCUsage - Claude Code Token Usage Statistics

Quick Start

Commands