ccusage

Analyze coding (agent) CLI token usage and costs from local data.

ccusage reads local usage data from coding agent CLIs and turns it into daily, weekly, monthly, and session reports.

Features:

• Daily Report: View token usage and costs aggregated by date
• Monthly Report: View token usage and costs aggregated by month
• Session Report: View usage grouped by conversation sessions
• Unified CLI Reports: View Claude Code, Codex, OpenCode, Amp, Droid, Codebuff, Hermes Agent, pi-agent, Goose, OpenClaw, Kilo, Kimi, Qwen, GitHub Copilot CLI, and Gemini CLI usage from one CLI
• 5-Hour Blocks Report: Track usage within Claude's billing windows with active block monitoring
• Statusline Integration: Compact usage display for Claude Code status bar hooks (Beta)
• Model Tracking: See which models are used across supported sources
• Model Breakdown: View per-model cost breakdown with --breakdown flag
• Date Filtering: Filter reports by date range using --since and --until
• Custom Paths: Support for custom local data directory locations
• Beautiful Output: Colorful table-formatted display with automatic responsive layout
• Smart Tables: Automatic compact mode for narrow terminals (< 100 characters) with essential columns
• Compact Mode: Use --compact flag to force compact table layout, perfect for screenshots and sharing
• Enhanced Model Display: Model names shown as bulleted lists for better readability
• JSON Output: Export data in structured JSON format with --json
• Cost Tracking: Shows costs in USD for each day/month/session
• Cost Hiding: Remove cost columns and JSON cost fields with --no-cost
• Cache Token Support: Tracks and displays cache creation and cache read tokens separately
• Offline Mode: Use pre-cached pricing data without network connectivity with --offline
• Custom Pricing Overrides: Override token pricing per raw model name in ccusage.json without rebuilding
• Claude Instance Support: Group Claude Code usage by project with --instances and filter by specific projects
• Timezone Support: Configure timezone for date grouping with --timezone option
• Configuration Files: Set defaults with JSON configuration files, complete with IDE autocomplete and validation