# ccstats
Fast Claude Code token usage statistics CLI.
## Installation
### Homebrew (macOS/Linux)
```bash
brew install majiayu000/tap/ccstats
```
### Cargo binstall (prebuilt binary)
```bash
cargo binstall ccstats
```
### Cargo install (from source)
```bash
cargo install ccstats
```
### Shell script
```bash
### Manual download
Download from [GitHub Releases](https://github.com/majiayu000/ccstats/releases).
## Usage
```bash
# 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
# Filter by date
ccstats daily --since 20260101 --until 20260131
```
## License
MIT