ccost

README

A CLI tool to analyze Claude Code token usage, costs, and session time.

Reads local JSONL session logs. No network access. Alternative to ccusage.

Installation

Homebrew

brew install zulerne/tap/ccost

Go install

go install github.com/zulerne/ccost/cmd/ccost@latest

Build from source

git clone https://github.com/zulerne/ccost.git
cd ccost
task build

Usage

ccost                                           # last 7 days (default)
ccost --since 2026-02-01 --until 2026-02-07     # custom date range
ccost --project myapp                           # filter by project
ccost --by-project                              # group by project
ccost --models                                  # per-model breakdown
ccost --by-project --models --since 2026-02-01  # combine flags
ccost --json                                    # JSON output
ccost --exact                                   # exact token counts (no K/M)

Contributing

See CONTRIBUTING.md for development setup and guidelines.

License

MIT