otty / apps
All apps/ccusage

ccusage

ccusage

A CLI tool for analyzing Claude Code usage from local JSONL files.

Runs as ccusage|macOS, Linux, Windows|github.com
Open form in Otty otty.toml

Command form

ai-draft · 2 tasks · 12 fields

Report Claude Code (and other coding CLI) token usage and cost by day, week, month or session. Blocks, statusline, per-agent namespaces and config-file options are left out.

Opens the form; the finished command lands at your prompt, unrun
Run in Otty
otty gui ccusage
Usage reportExample values, fixed in this page — nothing here reaches a terminal
Basic
Report* set by task
Dailyenum
Since
string
Until
string
Per-model breakdown
--breakdown
Sort order
2 choicesenum
Advanced
Offline
--offline
Group by project
--instances
Project
string
TasksEach one presets the form for one job
Daily usage
reportsinceuntilbreakdowninstancesprojectorderoffline
Monthly JSON
reportjsonsinceuntiltimezone
ParametersOnly these flags are editable in the form
Report
Which grouping to report.
enum · positional 0
dailyweeklymonthlysession
Since
Inclusive start date, YYYY-MM-DD or YYYYMMDD.
string
--since
Until
Inclusive end date, YYYY-MM-DD or YYYYMMDD.
string
--until
JSON output
boolean
--json-j
Per-model breakdown
boolean
--breakdown-b
Hide cost
boolean
--no-cost
Sort order
enum
--orderdescasc
Cost mode
enum
--modeautocalculatedisplay
Offline
Use cached pricing data.
boolean
--offline-O
Timezone
string
--timezone-zUTClocalAmerica/New_YorkAsia/Tokyo
Group by project
Daily report only.
boolean
--instances-i
Project
Daily report only.
string
--project-p
SourcesEvery flag above is checked against these
docs
ccusage daily --since 20260101 --until 20260531 ccusage monthly --since 20260101 ccusage session --until 20260531 ccusage weekly --last 1 ccusage daily --json ccusage daily -j ccusage daily --breakdown ccusage daily -b ccusage daily --no-cost ccusage daily --mode auto ccusage daily --mode calculate ccusage daily --mode display ccusage daily --order desc ccus…
manual2026-10-27

github.com

Before it fills your prompt, Otty checks the installed ccusage against its version. A form that does not match your version is not offered.