# ryoppippi/ccusage

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/ryoppippi-ccusage).**

10,826 stars · 371 forks · TypeScript · other

## Links

- GitHub: https://github.com/ryoppippi/ccusage
- Homepage: https://ccusage.com/
- awesome-repositories: https://awesome-repositories.com/repository/ryoppippi-ccusage.md

## Description

This project is a command-line utility designed to monitor and analyze token consumption and financial expenditure for AI coding assistants. By parsing local session logs directly on the user's machine, it provides a privacy-focused way to track development activity without transmitting sensitive data to external servers.

The tool distinguishes itself through its ability to aggregate disparate log formats from multiple coding assistants into a unified, schema-agnostic representation. It features a decoupled pricing engine that allows users to apply custom model-specific cost multipliers, override default pricing, and account for different service tiers. This enables granular reporting across various dimensions, including individual interaction sessions, specific projects, or custom time-based billing windows.

Beyond core tracking, the utility supports a wide range of analytical capabilities such as trend visualization, currency conversion, and the ability to inspect individual conversation logs. Users can configure reporting parameters, define project aliases, and export findings into machine-readable formats for further integration. The entire analysis process operates locally, ensuring that usage telemetry remains private and accessible even without an active network connection.

## Tags

### Data & Databases

- [Agent Usage Aggregators](https://awesome-repositories.com/f/data-databases/data-aggregation-pipelines/agent-usage-aggregators.md) — Consolidate local log files from multiple coding assistants into a unified report to track token consumption and estimated costs across different tools. ([source](https://ccusage.com/guide/))
- [Local Usage Aggregators](https://awesome-repositories.com/f/data-databases/local-databases/local-usage-aggregators.md) — Reads session logs from local databases to track model interactions and token consumption. ([source](https://ccusage.com/guide/kilo/))
- [Usage Reporting](https://awesome-repositories.com/f/data-databases/statistical-analysis-tools/usage-reporting.md) — Produces structured summaries of activity grouped by day, month, or session with support for compact terminal views. ([source](https://ccusage.com/guide/))
- [Schema-Agnostic Aggregators](https://awesome-repositories.com/f/data-databases/data-processing-pipelines/data-processing/data-normalization-schema-enforcement/schema-agnostic-aggregators.md) — Normalizes disparate log formats from multiple coding assistants into a unified internal representation for consistent analysis.
- [Log Aggregators](https://awesome-repositories.com/f/data-databases/log-aggregators.md) — Parses structured local log files to extract token counts and session metadata for unified analysis. ([source](https://ccusage.com/guide/source-support-qa))
- [Local](https://awesome-repositories.com/f/data-databases/log-aggregators/local.md) — Processes local session files and logs to generate usage metrics without transmitting data to external servers.
- [Gemini Usage Aggregators](https://awesome-repositories.com/f/data-databases/data-aggregation-pipelines/agent-usage-aggregators/gemini-usage-aggregators.md) — Parse local log files from specific directories to extract token consumption and session data for unified analysis. ([source](https://ccusage.com/guide/gemini/))
- [Kimi Usage Aggregators](https://awesome-repositories.com/f/data-databases/data-aggregation-pipelines/agent-usage-aggregators/kimi-usage-aggregators.md) — Parse local wire logs from specific command line tools to extract token consumption and cost data for unified analysis. ([source](https://ccusage.com/guide/kimi/))
- [Data Path Configurations](https://awesome-repositories.com/f/data-databases/data-governance-modeling/data-management-governance/data-management-tools/data-path-configurations.md) — Provides settings to define custom file paths and directories for log ingestion. ([source](https://ccusage.com/guide/amp/))
- [Usage Report Renderers](https://awesome-repositories.com/f/data-databases/data-serialization-formats/data-formats/output-format-rendering/usage-report-renderers.md) — Displays consumption data in tables or structured formats with customizable cost metric inclusion. ([source](https://ccusage.com/guide/cli-options))
- [Source Filters](https://awesome-repositories.com/f/data-databases/statistical-analysis-tools/usage-reporting/source-filters.md) — Isolates usage data for a specific assistant to generate detailed performance and cost metrics. ([source](https://ccusage.com/guide/all-reports))

### Development Tools & Productivity

- [AI Coding Assistants](https://awesome-repositories.com/f/development-tools-productivity/ai-coding-assistants.md) — Provides analytics and cost tracking for AI coding assistants by parsing local session logs.
- [Project Usage Categorizers](https://awesome-repositories.com/f/development-tools-productivity/project-scaffolding-config-code-generation/project-scaffolding-configuration/project-configuration/project-usage-categorizers.md) — Groups consumption metrics by project instance with support for custom naming aliases. ([source](https://ccusage.com/guide/configuration))
- [API Usage Analytics](https://awesome-repositories.com/f/development-tools-productivity/api-usage-analytics.md) — Groups AI coding assistant activity by session and project to identify usage patterns and trends.
- [Reporting Default Configurations](https://awesome-repositories.com/f/development-tools-productivity/global-defaults/reporting-default-configurations.md) — Defines shared settings for consumption reports, including options to hide cost data or apply consistent formatting. ([source](https://ccusage.com/guide/config-files))
- [Command Line Configuration](https://awesome-repositories.com/f/development-tools-productivity/command-line-configuration.md) — Customizes reporting through local configuration files, environment variables, or command-line arguments. ([source](https://ccusage.com/guide/))
- [Developer Productivity](https://awesome-repositories.com/f/development-tools-productivity/developer-productivity.md) — Analyzes coding workflow patterns and session activity to provide insights into development productivity.
- [Path Mapping Configurations](https://awesome-repositories.com/f/development-tools-productivity/path-mapping-configurations/path-mapping-configurations.md) — Provides configurable mapping of log file paths and pricing overrides for accurate usage analysis.
- [Reporting Timezone Configurations](https://awesome-repositories.com/f/development-tools-productivity/timezone-configuration/reporting-timezone-configurations.md) — Adjusts temporal references for date-based calculations to ensure logs align with local time zones. ([source](https://ccusage.com/guide/cli-options))

### System Administration & Monitoring

- [AI Cost Monitoring](https://awesome-repositories.com/f/system-administration-monitoring/ai-cost-monitoring.md) — Calculates financial expenditure based on token usage and cached pricing data for major AI model providers. ([source](https://ccusage.com/guide/codebuff/))
- [Token Cost Calculators](https://awesome-repositories.com/f/system-administration-monitoring/usage-monitoring/token-usage-analytics/token-cost-calculators.md) — Monitors and aggregates token usage data from coding assistants to provide detailed financial and activity reports. ([source](https://ccusage.com/guide/cost-modes))
- [Token Usage Analytics](https://awesome-repositories.com/f/system-administration-monitoring/usage-monitoring/token-usage-analytics.md) — Parses local logs to calculate token consumption and estimate costs across various AI models. ([source](https://ccusage.com/guide/cli-options))
- [Log Aggregation](https://awesome-repositories.com/f/system-administration-monitoring/log-aggregation.md) — Consolidates token usage and activity data from local session and message files. ([source](https://ccusage.com/guide/openclaw/))
- [Conversation Cost Aggregators](https://awesome-repositories.com/f/system-administration-monitoring/performance-monitoring-tools/conversation-cost-aggregators.md) — Parses local session files from coding assistants to calculate total token consumption and estimate costs. ([source](https://ccusage.com/guide/codex/))
- [Usage Monitoring](https://awesome-repositories.com/f/system-administration-monitoring/usage-monitoring.md) — Computes financial expenditure using offline pricing caches and per-model breakdown modes. ([source](https://ccusage.com/guide/configuration))
- [Offline Analysis Engines](https://awesome-repositories.com/f/system-administration-monitoring/network-operation-logs/offline-analysis-engines.md) — Uses locally cached pricing information to perform cost calculations and usage analysis when offline. ([source](https://ccusage.com/guide/daily-reports))
- [Embedded Cost Extractors](https://awesome-repositories.com/f/system-administration-monitoring/performance-monitoring-tools/conversation-cost-aggregators/embedded-cost-extractors.md) — Reads pre-calculated cost values directly from session logs to provide accurate financial reporting. ([source](https://ccusage.com/guide/openclaw/))
- [Session Activity Monitors](https://awesome-repositories.com/f/system-administration-monitoring/system-activity-monitoring/session-activity-monitors.md) — Displays hierarchical session activity to track complex multi-agent interactions. ([source](https://ccusage.com/guide/opencode/))
- [Trend Analysis](https://awesome-repositories.com/f/system-administration-monitoring/trend-analysis.md) — Visualizes changes in token consumption and model adoption over time to monitor shifts in activity. ([source](https://ccusage.com/guide/monthly-reports))
- [Metrics Visualizers](https://awesome-repositories.com/f/system-administration-monitoring/metrics-visualizers.md) — Displays token consumption and spending data through graphical dashboards and terminal interfaces. ([source](https://ccusage.com/guide/community-projects))
- [Real-Time Monitoring](https://awesome-repositories.com/f/system-administration-monitoring/real-time-monitoring.md) — Renders a compact summary of current token consumption directly within the command line interface for immediate feedback. ([source](https://ccusage.com/guide/claude/))

### Security & Cryptography

- [Data Privacy Tools](https://awesome-repositories.com/f/security-cryptography/data-privacy-tools.md) — Performs all analysis locally on the user machine without transmitting usage data to external servers. ([source](https://ccusage.com/guide/))
- [Local Data Processing Tools](https://awesome-repositories.com/f/security-cryptography/local-data-processing-tools.md) — Ensures data privacy by processing sensitive session logs and usage telemetry entirely on the local machine.

### Software Engineering & Architecture

- [Local-First Architectures](https://awesome-repositories.com/f/software-engineering-architecture/local-first-architectures.md) — Processes raw session files directly on the user machine to ensure data privacy and offline availability.
- [Pricing Engines](https://awesome-repositories.com/f/software-engineering-architecture/software-architecture/architectural-patterns/modular-decoupled-design/decoupled-architectures/pricing-engines.md) — Calculates financial expenditure by applying model-specific cost multipliers to token counts independently of data ingestion.

### Artificial Intelligence & ML

- [LLM Cost Management](https://awesome-repositories.com/f/artificial-intelligence-ml/llm-cost-management.md) — Calculates financial expenditure by mapping token counts to pricing models for recorded activity. ([source](https://ccusage.com/guide/goose/))
- [Usage Analytics](https://awesome-repositories.com/f/artificial-intelligence-ml/usage-analytics.md) — Organizes consumption data by individual interaction sessions to provide granular insight. ([source](https://ccusage.com/guide/codex/))
- [Conversational Session Management](https://awesome-repositories.com/f/artificial-intelligence-ml/conversational-session-management.md) — Breaks down aggregated data into specific conversation logs to review performance and cost. ([source](https://ccusage.com/guide/getting-started))

### Business & Productivity Software

- [Model Pricing Managers](https://awesome-repositories.com/f/business-productivity-software/pricing-structures/model-pricing-managers.md) — Updates and maintains a database of current model costs to ensure accurate financial analysis. ([source](https://ccusage.com/guide/cost-modes))
- [Model Pricing Overrides](https://awesome-repositories.com/f/business-productivity-software/pricing-structures/model-pricing-overrides.md) — Supplies custom token costs for specific models to ensure accurate financial tracking. ([source](https://ccusage.com/guide/config-files))
- [Usage Grouping](https://awesome-repositories.com/f/business-productivity-software/project-task-management/hierarchical-task-nesting/usage-grouping.md) — Organizes flat log entries into nested structures by session, project, or timeframe to enable granular reporting.
- [Service Tier Selectors](https://awesome-repositories.com/f/business-productivity-software/billing-and-subscription-management/tiered-capability-scaling/service-tier-selectors.md) — Applies pricing models based on service tiers and model-specific multipliers to estimate expenses. ([source](https://ccusage.com/guide/codex/))
- [Usage-Based Billing](https://awesome-repositories.com/f/business-productivity-software/financial-operational-management/billing-financial-systems/billing-quotas/usage-based-billing.md) — Calculates usage patterns within specific time-based billing blocks to help monitor and optimize service costs. ([source](https://ccusage.com/guide/claude/))
- [Weekly Usage Aggregators](https://awesome-repositories.com/f/business-productivity-software/financial-operational-management/billing-financial-systems/billing-quotas/usage-based-billing/tenant-usage-aggregators/weekly-usage-aggregators.md) — Summarizes token consumption and costs on a weekly basis for project activity tracking. ([source](https://ccusage.com/guide/weekly-reports))

### User Interface & Experience

- [Session](https://awesome-repositories.com/f/user-interface-experience/data-table-generators/usage-analyzers/session.md) — Groups token consumption data by individual interaction sessions to identify high-cost workflows. ([source](https://ccusage.com/guide/kimi/))
- [Usage Period Analyzers](https://awesome-repositories.com/f/user-interface-experience/data-table-generators/usage-analyzers/usage-period-analyzers.md) — Groups consumption data into daily, weekly, or monthly intervals to identify trends and patterns in development activity. ([source](https://ccusage.com/guide/cli-options))

### DevOps & Infrastructure

- [Agent Log Path Overrides](https://awesome-repositories.com/f/devops-infrastructure/configuration-management/configuration-resolution-engines/configuration-overrides/directory-path-overrides/agent-log-path-overrides.md) — Allows users to specify custom directories where coding assistant logs are stored for parsing. ([source](https://ccusage.com/guide/environment-variables))