ccusage

ccusage is a local CLI tool that tracks token usage and estimated costs for coding agent CLIs.

ccusage is a fast local command-line interface for tracking token consumption and estimated costs across a wide range of coding agent CLIs, including Claude Code, Codex, OpenCode, Amp, Droid, Codebuff, Hermes Agent, pi-agent, Goose, OpenClaw, Kilo, Kimi, Qwen, GitHub Copilot CLI, Gemini CLI, Antigravity, Grok Build CLI, and ZCode. It reads local usage logs directly without uploading your data, ensuring privacy. The tool estimates USD spend based on token counts and model pricing, includes cache token accounting with separate tracking for cache creation and read tokens, and operates offline using pre-cached pricing data. Users can view all detected sources by default, narrow views to a single source, read responsive terminal tables, and export data in structured JSON format for programmatic use. It is designed for developers who use coding agent CLIs and need visibility into their token expenditure and project history.

ccusage at a glance

Best for: Software engineer
Runs on: CLI
Pricing: Free
Released: May 2025
Category: AI coding tool
Website: ccusage.com

Key features

Tracks tokens and costs across multiple coding agent CLIs
Reads local usage logs without data uploads
Estimates USD spend from token counts and model pricing
Tracks cache creation and cache read tokens separately
Exports data in structured JSON format
Provides responsive terminal tables for readability
Supports offline mode with pre-cached pricing data

Use it for

Analyze token usage across multiple coding agent CLIs
Estimate USD spend on AI coding tools from local logs
Export token consumption data in JSON format
Monitor cache creation and read tokens offline

Alternatives to ccusage

TokenTracker — Monitor AI spending across 43 coding tools in one local, private dashboard.
Ccm — Measures codebases, traces change impact, and estimates resource costs locally.
Opaline — Track team-wide token costs and coding session analytics.
CodeBurn — Tracks AI coding token usage and costs locally across 41 tools and agents.
Cost X-Ray — It prices usage below the tool level by analyzing raw API request bytes.
Lcc — Cuts token counts significantly without losing exact session details.
jevgrep — Reduces coding agent costs by providing targeted, relevant repository context.
Context Autopsy — Breaks down token usage by category and tracks processed tokens locally.
Claude Code Usage Monitor — Tracks token usage, message counts, and session costs with local history and alerts.
Ctxvitals — Measures exact token costs and security risks before agent launch.
Tokscale — Track and compare token usage across multiple AI coding agents.
CC Switch — Centralizes AI coding tool management, API routing, and usage tracking in one interface.

All ccusage alternatives