ccusage/ccusage

Health v2 · maintenance only

Flags: no_license

Adoption not part of the score

18176 stars · 808 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded

ccusage is a fast local CLI that analyzes token usage and estimated costs from coding agent CLIs such as Claude Code, Codex, OpenCode, Gemini CLI, and many others by reading their local JSONL logs. It produces daily, weekly, monthly, and session-level reports with USD cost estimates, cache token accounting, JSON export, and offline pricing support.

Use cases

• track how much I spend on Claude Code tokens per day
• estimate monthly cost of my coding agent usage
• analyze token usage across multiple AI coding CLIs
• export my LLM usage data as JSON
• view Claude Code usage without uploading logs
• check cache token costs for AI coding sessions
• monitor AI coding spend offline

When to choose

• you use Claude Code, Codex, or similar coding agent CLIs and want local, private usage and cost analysis
• you need aggregated daily/weekly/monthly/session reports of token consumption
• you want JSON output for programmatic processing of usage data
• you need offline cost estimation with pre-cached model pricing

When to avoid

• you need real-time usage dashboards or team-level spend management rather than local CLI reports
• your AI tool is not among the supported coding agent CLIs
• you need exact billing data from your provider rather than estimates from token counts and pricing

Facets

cli-tool · maturity active

cli analytics developer-tools developer-tools analytics large-language-models cli cross-platform windows claude-code token-usage cost-tracking llm-usage-analysis coding-agents l-logs command-line macos linux

Member repositories

For agents

markdown · JSON · MCP: product_card(name="ccusage/ccusage")