Command
Inspect the per-provider account registry. cctally observes which Claude or Codex account each usage sample was written under — reading the provider's own on-disk credential state, never any third-party switcher tool — and records milestones, quota, and alerts per account. This subcommand lists the observed accounts…
Command
Opt-in OS notifications when usage crosses a percent threshold on the weekly subscription axis or the 5h-block axis. Off by default; once enabled, alerts fire automatically from record-usage on any new percent crossing — no extra wiring beyond enabling the feature. The OS popup is dispatched cross-platform — osascript…
Command
Claude usage grouped by 5-hour session block.
Command
Track spend against a budget, per vendor (Claude and/or Codex) over a configurable calendar period. cctally budget shows spend, pace, projected end-of-period, and a verdict (ok / warn / over); cctally budget set and cctally budget unset manage the budget. When a budget is set and alerts are enabled, a desktop alert…
Command
Claude cache diagnostics or Codex cached-input/token-reuse analytics across days or sessions. Provider sections stay separate because their token and cache semantics differ.
Command
Prime or rebuild the compact accounting cache (cache.db) and independent transcript/search store (conversations.db).
Command
Claude-source usage reports under a hierarchical subgroup. Drop-in for ccusage claude — paste a ccusage claude … command verbatim and it runs offline.
Command
Codex (OpenAI) usage grouped by date. Drop-in replacement for upstream ccusage-codex daily, offline.
Command
Codex (OpenAI) usage grouped by calendar month. Drop-in replacement for upstream ccusage-codex monthly, offline.
Command
Per-percent cumulative and marginal Codex cost milestones for one native seven-day quota cycle. Its terminal output uses the same week header, section label, boxed table, columns, alignment, and number formatting as cctally percent-breakdown.
Command
Provider-native Codex quota history, current status, forecasts, reset blocks, and percent-crossing breakdowns. This is a nested-only cctally extension; it does not have a flat alias and is not a ccusage-codex drop-in.
Command
Codex (OpenAI) usage grouped by session. Drop-in replacement for ccusage-codex session, offline.
Command
Codex (OpenAI) usage grouped by week (week-start day from config.json).
Command
Codex (OpenAI) usage reports and native quota views under a hierarchical subgroup. daily/monthly/session are drop-ins for ccusage codex — paste a ccusage codex … command verbatim and it runs offline. weekly is a cctally extension (upstream has no ccusage codex weekly).
Command
Manage cctally user preferences in /.local/share/cctally/config.json.
Command
Claude usage grouped by date. Drop-in replacement for ccusage daily, offline.
Command
Read a running dashboard's tick cost, and arm or disarm its deep phase trace. Answers the question "why is my dashboard slow, and how slow is it?" from the running process — no restart, and no CCTALLYPERFTRACE=1 at launch.
Command
Launch a live web dashboard rendering your current subscription usage, forecast, $/1% trend, and recent sessions. Coexists with the tui subcommand — use tui over SSH or when a browser isn't available.
Command
Migration / DB-management subcommand. Twelve actions: status, skip, unskip, rebuild, rederive, journal-repair, recover, repair, backup, checkpoint, prune, and vacuum.
Command
Compare Claude usage between two windows in a single bordered-table render. Answers "what changed between this week and last week — and which models, projects, and cache patterns drove the change?".
Command
Read-only diagnostic. Answers the question: "why is my cctally data stale or broken?" by running every passive check across install, hooks, OAuth, database, data freshness, pricing coverage, and safety config, then emitting a severity-ranked report.
Command
Explain where locally retained usage went, over seven contributor classes — four accounting-native and three conversation-derived — ranked by observed cost and backed by evidence you can navigate to.
Command
List API-anchored 5-hour blocks with rollup totals plus 7d-drift columns.
Command
Per-percent cumulative + marginal cost milestones inside a single API-anchored 5-hour block. Mirror of percent-breakdown for the 5h axis.