Menu
Guides ccusage agent source formats. Use when checking agent log locations, raw record structure, token mappings, model names, precomputed costs, or source-specific CLI behavior.
| name | agent-sources |
| description | Guides ccusage agent source formats. Use when checking agent log locations, raw record structure, token mappings, model names, precomputed costs, or source-specific CLI behavior. |
Use this skill when inspecting source data formats, log paths, token normalization, precomputed cost semantics, or source-specific command behavior for any supported agent.
Reports aggregate raw usage into daily, monthly, session, or billing-block summaries and output either tables or JSON.
The canonical command surface is the unified ccusage CLI:
ccusage daily
ccusage codex daily
ccusage opencode daily
ccusage amp daily
ccusage pi daily
Standalone agent wrapper packages have been removed. Use the unified ccusage <agent> ... commands in docs, tests, and examples, and do not reintroduce wrapper commands such as ccusage-codex, ccusage-opencode, ccusage-amp, or ccusage-pi.
Cost modes:
auto - prefer pre-calculated costUSD when available, otherwise calculate from tokens.calculate - calculate from token counts and ignore pre-calculated costs.display - use pre-calculated costs and show 0 when missing.Pricing generally comes from LiteLLM's model_prices_and_context_window.json. The --offline flag forces embedded pricing snapshots where supported.
Read only the relevant adapter README before changing parser behavior, token mappings, data directory detection, fallback models, or agent-specific CLI flags:
rust/crates/ccusage/src/adapter/claude/README.mdrust/crates/ccusage/src/adapter/codex/README.mdrust/crates/ccusage/src/adapter/opencode/README.mdrust/crates/ccusage/src/adapter/amp/README.mdrust/crates/ccusage/src/adapter/pi/README.mdAgent adapter architecture lives in
rust/crates/ccusage/src/adapter/AGENTS.md. Read that local architecture file
when changing adapter module layout, shared implementation boundaries, migration
strategy, tests, docs, terminal output, or benchmark expectations.
Keep command names and flag semantics aligned across agents unless the source data forces a difference.
Runs the full PR lifecycle. Use when creating a branch, committing, pushing, opening a PR, requesting AI review, and driving CI and review to completion.
Guides ccusage monorepo development. Use when editing packages, docs, shared configuration, bundled CLI packaging, dependencies, exports, or validation commands.
Guides repo-local skill creation and updates. Use when adding or editing .agents/skills, SKILL.md frontmatter, references, scripts, or skill routing.
Guides ccusage Rust and Vitest tests. Use when adding or fixing cargo tests, CLI snapshots, Claude model pricing, LiteLLM compatibility, Vitest tests, or fixture-backed tests.
Guides ccusage TypeScript and JavaScript work. Use before reading or editing .ts, .tsx, .js, or .jsx files, including package launchers, Vitest tests, Bun scripts, schemas, mocks, and typed fixtures.
Guides t-wada Red-Green-Refactor TDD. Use when implementing features, fixing bugs, or refactoring logic with strict test-first development.