A CLI tool for analyzing Claude Code/Codex CLI usage from local JSONL files.
ccusage is a command-line tool that analyzes usage data from Anthropic's Claude Code and Codex CLI tools by processing local JSONL log files. It helps developers track their API consumption patterns, estimate costs, and gain insights into how they're using AI-assisted coding tools in their workflows.
Developers and teams using Anthropic's Claude Code or Codex CLI tools who want to monitor their API usage, track costs, and optimize their AI-assisted coding workflows.
Unlike cloud-based analytics services, ccusage processes data locally for privacy and provides detailed, customizable reports about Claude Code/Codex usage without requiring API calls or external services.
A CLI tool for analyzing Claude Code/Codex CLI usage from local JSONL files.
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
Processes JSONL files locally without sending data to external servers, ensuring user privacy as emphasized in the project's philosophy.
Calculates estimated costs based on token consumption and Anthropic's API pricing, helping users track and optimize expenses with detailed breakdowns.
Generates interactive reports with filters by time, project, or model, and supports export to CSV, JSON, and human-readable formats for easy analysis.
Uses a simple command-line interface that integrates seamlessly into developer workflows, adhering to Unix principles for efficiency and scriptability.
Only works with JSONL files from Claude Code and Codex CLI, making it incompatible with other AI coding tools without significant modification.
Relies on processing static log files, so it cannot provide live usage monitoring or instant updates, which may hinder dynamic workflow adjustments.
Vulnerable to breaking changes if Anthropic alters the JSONL log format, potentially requiring frequent updates to maintain functionality.