ccstats is a fast CLI for token and cost usage analytics for Claude Code and OpenAI Codex logs.
Search keywords: claude code usage stats, codex usage stats, token usage cli, ai token cost tracker.
- Fast local analysis of usage JSONL logs
- Claude Code support (
~/.claude/projects/) - OpenAI Codex support (
~/.codex/sessions/) - Daily/weekly/monthly/project/session views
- Optional model-level token and cost breakdown
brew install majiayu000/tap/ccstatscargo binstall ccstatscargo install ccstatscurl -fsSL https://raw.githubusercontent.com/majiayu000/ccstats/main/install.sh | shDownload from GitHub Releases.
# Install
brew install majiayu000/tap/ccstats
# Today
ccstats codex today
# Daily trend
ccstats codex daily
# Same result via unified source flag
ccstats daily --source codex# Today's usage
ccstats today
# Daily breakdown
ccstats daily
# Weekly summary
ccstats weekly
# Monthly summary
ccstats monthly
# By project
ccstats project
# By session
ccstats session
# 5-hour billing blocks
ccstats blocks
# With model breakdown
ccstats today -b
# JSON output
ccstats today -j
# Debug mode (timing info)
ccstats today --debug# Codex subcommand mode
ccstats codex daily
# Or use unified source flag
ccstats daily --source codex
# Today's Codex usage
ccstats codex today
# Daily Codex breakdown
ccstats codex daily
# Weekly Codex summary
ccstats codex weekly
# By session
ccstats codex session
# With model breakdown
ccstats codex today -b# Bucket by timezone
ccstats daily --timezone UTC
# Locale-aware number formatting
ccstats monthly --locale de
# Filter by date
ccstats daily --since 20260101 --until 20260131
# Select data source explicitly (supports aliases)
ccstats daily --source codex
# Offline mode (use cached pricing)
ccstats today -O
# Compact output
ccstats today -c
# Hide cost column
ccstats today --no-costccstats session --csv now includes:
reasoning_tokenscache_creation_tokenscache_read_tokens
When malformed JSONL records are encountered, ccstats reports them in stderr:
Warning: ignored <N> malformed records
| Source | Directory | Features |
|---|---|---|
| Claude Code | ~/.claude/projects/ |
Projects, Billing Blocks, Deduplication |
| OpenAI Codex | ~/.codex/sessions/ |
Reasoning Tokens |
See docs/ARCHITECTURE.md for:
- Adding new data sources
- Data flow and processing pipeline
- Caching mechanism
- Deduplication algorithm
MIT. See LICENSE.