About
Reads local logs from Claude Code, Codex, Gemini CLI and others and reports tokens and cost by day, week, month or session. Runs with npx.
Features
- 01Usage and cost by day, week, month or session
- 02See what’s left in the current 5-hour window
- 03Reads local logs only; nothing is uploaded
Install
- 1Run with npx
npx ccusage@latest - 2Or with Bun
bunx ccusage
RequirementsRequires Node.js (or Bun).
ccusage is made by ryoppippi and is not affiliated with Spare.
Other open-source tools4
CodexBarSee how much of each AI plan is left, and when it resets, from the menu bar21.9kmacOS 14+LinuxccstatuslineKeep model, branch, cost and time left visible at the bottom of Claude Code13kmacOSLinuxWindowsClaude Code Usage MonitorWatch how fast you burn Claude Code quota and when it runs out8.7kmacOSLinuxWindowsCode-NotifyGet a desktop alert when your AI agent finishes or needs you290macOSLinuxWindows
Built-in tools3
Made by the Spare team. Open them on the web or in the desktop app.








