--- title: "Daily Reports" description: "![Daily usage report showing token usage and costs by date with model breakdown](/screenshot.png)" type: skill canonical_url: https://claudary.paisolsolutions.com/skills/daily-reports source: "Claudary" difficulty: intermediate author: "Claude Code Knowledge Pack" date: 2026-07-10T11:19:19.314Z license: CC-BY-4.0 attribution: "Daily Reports — Claudary (https://claudary.paisolsolutions.com/skills/daily-reports)" --- # Daily Reports ![Daily usage report showing token usage and costs by date with model breakdown](/screenshot.png) ## Overview # Daily Reports ![Daily usage report showing token usage and costs by date with model breakdown](/screenshot.png) Daily reports show token usage and costs aggregated by calendar date, giving you a clear view of your Claude Code usage patterns over time. ## Basic Usage Show all daily usage: ```bash ccusage daily # or simply: ccusage ``` The daily command is the default, so you can omit it when running ccusage. ## Example Output ![Daily usage report showing token usage and costs by date with model breakdown](/screenshot.png) ## Understanding the Columns ### Basic Columns - **Date**: Calendar date in YYYY-MM-DD format - **Models**: Claude models used that day (shown as bulleted list) - **Input**: Total input tokens sent to Claude - **Output**: Total output tokens received from Claude - **Cost (USD)**: Estimated cost for that day ### Cache Columns - **Cache Create**: Tokens used to create cache entries - **Cache Read**: Tokens read from cache (typically cheaper) ### Responsive Display ccusage automatically adapts to your terminal width: - **Wide terminals (≥100 chars)**: Shows all columns - **Narrow terminals (<100 chars)**: Compact mode with essential columns only ## Command Options ### Date Filtering Filter reports by date range: ```bash # Show usage from December 2024 ccusage daily --since 20241201 --until 20241231 # Show last week ccusage daily --since 20241215 --until 20241222 # Show usage since a specific date ccusage daily --since 20241201 ``` ### Sort Order Control the order of dates: ```bash # Newest dates first (default) ccusage daily --order desc # Oldest dates first ccusage daily --order asc ``` ### Cost Calculation Modes Control how costs are calculated: ```bash # Use pre-calculated costs when available (default) ccusage daily --mode auto # Always calculate costs from tokens ccusage daily --mode calculate # Only show pre-calculated costs ccusage daily --mode display ``` ### Model Breakdown See per-model cost breakdown: ```bash ccusage daily --breakdown ``` This shows costs split by individual models: ``` ┌──────────────┬──────────────────┬────────┬─────────┬────────────┐ │ Date │ Models │ Input │ Output │ Cost (USD) │ ├──────────────┼──────────────────┼────────┼─────────┼────────────┤ │ 2025-06-21 │ opus-4, sonnet-4 │ 277 │ 31,456 │ $17.58 │ ├──────────────┼──────────────────┼────────┼─────────┼────────────┤ │ └─ opus-4 │ │ 100 │ 15,000 │ $10.25 │ ├──────────────┼──────────────────┼────────┼─────────┼────────────┤ │ └─ sonnet-4│ │ 177 │ 16,456 │ $7.33 │ └──────────────┴──────────────────┴────────┴─────────┴────────────┘ ``` ### JSON Output Export data as JSON for further analysis: ```bash ccusage daily --json ``` ```json { "type": "daily", "data": [ { "date": "2025-06-21", "models": ["claude-opus-4-20250514", "claude-sonnet-4-20250514"], "inputTokens": 277, "outputTokens": 31456, "cacheCreationTokens": 512, "cacheReadTokens": 1024, "totalTokens": 33269, "costUSD": 17.58 } ], "summary": { "totalInputTokens": 277, "totalOutputTokens": 31456, "totalCacheCreationTokens": 512, "totalCacheReadTokens": 1024, "totalTokens": 33269, "totalCostUSD": 17.58 } } ``` ### Offline Mode Use cached pricing data without network access: ```bash ccusage daily --offline # or short form: ccusage daily -O ``` ### Project Analysis Group usage by project instead of aggregating across all projects: ```bash # Group daily usage by project ccusage daily --instances ccusage daily -i ``` When using `--instances`, the report shows usage for each project separately: ``` ┌──────────────┬────────────────────────────────────────────────────────────────────────────────────────────┐ │ Project: my-project │ ├──────────────┬──────────────────┬────────┬─────────┬────────────┬────────────┬─────────────┬──────────┤ │ Date │ Models │ Input │ Output │ Cache Create│ Cache Read │ Total Tokens│ Cost (USD)│ ├──────────────┼──────────────────┼────────┼─────────┼────────────┼────────────┼─────────────┼──────────┤ │ 2025-06-21 │ • sonnet-4 │ 277 │ 31,456 │ 512│ 1,024 │ 33,269 │ $7.33│ └──────────────┴──────────────────┴────────┴─────────┴────────────┴────────────┴─────────────┴──────────┘ ┌──────────────┬────────────────────────────────────────────────────────────────────────────────────────────┐ │ Project: other-project │ ├──────────────┬──────────────────┬────────┬─────────┬────────────┬────────────┬─────────────┬──────────┤ │ Date │ Models │ Input │ Output │ Cache Create│ Cache Read │ Total Tokens│ Cost (USD)│ ├──────────────┼──────────────────┼────────┼─────────┼────────────┼────────────┼─────────────┼──────────┤ │ 2025-06-21 │ • opus-4 │ 100 │ 15,000 │ 256│ 512 │ 15,868 │ $10.25│ └──────────────┴──────────────────┴────────┴─────────┴────────────┴────────────┴─────────────┴──────────┘ ``` Filter to a specific project: ```bash # Show only usage from "my-project" ccusage daily --project my-project ccusage daily -p my-project # Combine with instances flag ccusage daily --instances --project my-project ``` ## Common Use Cases ### Track Monthly Spending ```bash # See December 2024 usage ccusage daily --since 20241201 --until 20241231 ``` ### Find Expensive Days ```bash # Sort by cost (highest first) ccusage daily --order desc ``` ### Export for Spreadsheet Analysis ```bash ccusage daily --json > december-usage.json ``` ### Compare Model Usage ```bash # See which models you use most ccusage daily --breakdown ``` ### Check Recent Activity ```bash # Last 7 days ccusage daily --since $(date -d '7 days ago' +%Y%m%d) ``` ### Analyze Project Usage ```bash # See usage breakdown by project ccusage daily --instances # Track specific project costs ccusage daily --project my-important-project --since 20250601 # Compare project usage with JSON export ccusage daily --instances --json > project-analysis.json ``` ### Team Usage Analysis Use project aliases to replace cryptic or long project directory names with readable labels: ```json // .ccusage/ccusage.json - Set custom project names for better reporting { "commands": { "daily": { "projectAliases": "uuid-project=Frontend App,long-name=Backend API" } } } ``` The `projectAliases` setting uses a comma-separated format of `original-name=display-name` pairs. This is especially useful when: - Your projects have UUID-based names (e.g., `a2cd99ed-a586=My App`) - Directory names are long paths that get truncated - You want consistent naming across team reports ```bash # Generate team report with readable project names ccusage daily --instances --since 20250601 # Now shows "Frontend App" instead of "uuid-project" ``` ## Tips 1. **Compact Mode**: If your terminal is narrow, expand it to see all columns 2. **Date Format**: Use YYYYMMDD format for date filters (e.g., 20241225) 3. **Regular Monitoring**: Run daily reports regularly to track usage patterns 4. **JSON Export**: Use `--json` for creating charts or additional analysis ## Related Commands - [Monthly Reports](/guide/monthly-reports) - Aggregate by month - [Session Reports](/guide/session-reports) - Per-conversation analysis - [Blocks Reports](/guide/blocks-reports) - 5-hour billing windows - [Live Monitoring](/guide/live-monitoring) - Real-time tracking --- Source: [Claudary](https://claudary.paisolsolutions.com/skills/daily-reports) · https://claudary.paisolsolutions.com