Repository navigation
feat: support human-readable token count display (K/M/B suffixes) #958
Description
Problem
Large token counts (e.g., 1,234,567) are hard to scan visually in terminal output. Users would benefit from an option to display token counts in compact, human-readable format with K/M/B suffixes.
Proposed Solution
Add a --human / -H CLI flag to all report commands (daily, weekly, monthly, session, blocks) across all apps (ccusage, codex, opencode, amp, pi). When enabled, token counts would display as compact values:
| Raw | Human-Readable |
|---|---|
| 1,234,567 | 1.23M |
| 500,000 | 500K |
| 2,500 | 2.5K |
| 999 | 999 |
Implementation Notes
- Use
Intl.NumberFormatwithnotation: 'compact'for standards-based formatting - JSON output should remain unchanged (raw numbers always)
- Only affects table/terminal display
- The flag should be available across all apps, not just ccusage
Related
- PR feat(ccusage): add --human/-H flag for human-readable token display #940 addresses this for ccusage only; this issue tracks comprehensive support across all apps
Activity
feat: add --human/-H flag for human-readable token display
feat: add --human/-H flag for human-readable token display
ryoppippi commentedon May 19, 2026
Thank you for the report/suggestion and for the related TypeScript-era work.
I am sorry that the Rust migration made the original TypeScript implementation no longer mergeable as-is. The production CLI has moved from the TypeScript implementation to the Rust implementation under
rust/crates/ccusage. The related TypeScript PR has been closed as obsolete, so I am closing this issue as well to keep the tracker focused.If this behavior is still needed, please open a fresh issue or PR against the current Rust CLI with current-version output and a minimal reproduction or concrete use case.