# ccusage

## Docs

- [Cost Calculation Modes](https://mintlify.wiki/ryoppippi/ccusage/advanced/cost-modes.md): Control how ccusage calculates costs with auto, calculate, and display modes
- [JSON Output Format](https://mintlify.wiki/ryoppippi/ccusage/advanced/json-output.md): Export ccusage data in structured JSON format for programmatic consumption
- [Library Usage](https://mintlify.wiki/ryoppippi/ccusage/advanced/library-usage.md): Use ccusage as a TypeScript library in your own projects
- [MCP Server Integration](https://mintlify.wiki/ryoppippi/ccusage/advanced/mcp-server.md): Access ccusage data through Model Context Protocol for Claude Desktop and other MCP clients
- [blocks](https://mintlify.wiki/ryoppippi/ccusage/api/commands/blocks.md): Show usage report grouped by session billing blocks
- [daily](https://mintlify.wiki/ryoppippi/ccusage/api/commands/daily.md): Show usage report grouped by date
- [monthly](https://mintlify.wiki/ryoppippi/ccusage/api/commands/monthly.md): Show usage report grouped by month
- [session](https://mintlify.wiki/ryoppippi/ccusage/api/commands/session.md): Show usage report grouped by conversation session
- [statusline](https://mintlify.wiki/ryoppippi/ccusage/api/commands/statusline.md): Display compact status line for Claude Code hooks with hybrid caching (Beta)
- [weekly](https://mintlify.wiki/ryoppippi/ccusage/api/commands/weekly.md): Show usage report grouped by week
- [Calculate Cost](https://mintlify.wiki/ryoppippi/ccusage/api/library/calculate-cost.md): Utilities for calculating costs and aggregating token usage
- [Data Loader](https://mintlify.wiki/ryoppippi/ccusage/api/library/data-loader.md): Functions for loading and parsing Claude Code usage data from JSONL files
- [Debug](https://mintlify.wiki/ryoppippi/ccusage/api/library/debug.md): Debug utilities for cost calculation validation and pricing mismatch detection
- [Logger](https://mintlify.wiki/ryoppippi/ccusage/api/library/logger.md): Logging utilities for consistent application logging with consola
- [CLI Options](https://mintlify.wiki/ryoppippi/ccusage/configuration/cli-options.md): Command-line flags and options for ccusage commands
- [Configuration Files](https://mintlify.wiki/ryoppippi/ccusage/configuration/config-files.md): JSON configuration files for setting default options and command-specific settings
- [Custom Data Paths](https://mintlify.wiki/ryoppippi/ccusage/configuration/custom-paths.md): Managing multiple Claude Code installations and custom data directories
- [Environment Variables](https://mintlify.wiki/ryoppippi/ccusage/configuration/environment-variables.md): Environment variables for controlling ccusage behavior
- [@ccusage/amp](https://mintlify.wiki/ryoppippi/ccusage/family/amp.md): Usage analyzer for Amp with credits tracking
- [@ccusage/codex](https://mintlify.wiki/ryoppippi/ccusage/family/codex.md): Usage analyzer for OpenAI Codex with GPT-5 support
- [@ccusage/mcp](https://mintlify.wiki/ryoppippi/ccusage/family/mcp.md): MCP server for real-time ccusage integration
- [@ccusage/opencode](https://mintlify.wiki/ryoppippi/ccusage/family/opencode.md): Usage analyzer for OpenCode sessions
- [ccusage Family](https://mintlify.wiki/ryoppippi/ccusage/family/overview.md): A suite of related tools for tracking usage across AI coding assistants
- [@ccusage/pi](https://mintlify.wiki/ryoppippi/ccusage/family/pi.md): Usage analyzer for pi-agent sessions
- [Billing Blocks](https://mintlify.wiki/ryoppippi/ccusage/features/blocks-reports.md): Track usage in 5-hour billing cycles with active block monitoring
- [Daily Reports](https://mintlify.wiki/ryoppippi/ccusage/features/daily-reports.md): Track your Claude Code usage with detailed daily breakdowns
- [Monthly Reports](https://mintlify.wiki/ryoppippi/ccusage/features/monthly-reports.md): View aggregated monthly usage statistics for long-term cost tracking
- [Session Reports](https://mintlify.wiki/ryoppippi/ccusage/features/session-reports.md): Track usage grouped by conversation sessions and project directories
- [Status Line (Beta)](https://mintlify.wiki/ryoppippi/ccusage/features/statusline.md): Compact status display for terminal hooks and prompts
- [Weekly Reports](https://mintlify.wiki/ryoppippi/ccusage/features/weekly-reports.md): Analyze usage patterns with weekly aggregated reports
- [Installation](https://mintlify.wiki/ryoppippi/ccusage/installation.md): Install ccusage with your preferred package manager or run it directly without installation
- [Introduction](https://mintlify.wiki/ryoppippi/ccusage/introduction.md): Analyze your Claude Code token usage and costs from local JSONL files — incredibly fast and informative
- [Quick start](https://mintlify.wiki/ryoppippi/ccusage/quickstart.md): Get started with ccusage and run your first usage report in seconds