Budgethelm

A ccusage alternative? First decide what you need

ccusage and Budgethelm do not solve exactly the same problem. This page only states what each publicly does, and says plainly when to keep ccusage.

Data as of 2026-10-31

Sign up free Log in

What ccusage is

According to its GitHub README (checked around 2026-10-31), ccusage reads the local data that coding agent CLIs leave on your machine and turns it into daily, weekly, monthly and per-session reports. It covers Claude Code, Codex, Gemini CLI, GitHub Copilot CLI and others, is MIT-licensed and has an offline mode.

Side by side

ccusageBudgethelm
Main jobLocal usage and cost reportsUsage reports, plus stopping an agent right when it gets stuck
Where data livesOn this computerOnly time, tool, model, token counts and stop records go to your account
Several computersEach shows its own local dataEvery computer you install it on, in one place
Runaway agentYou read the report afterwardsStops at a threshold, with a desktop notification
Config securityNot its scopeChecks AGENTS.md, CLAUDE.md and MCP configs
Source and priceMIT open sourceFree to use (paid plans are planned; see Plans on the home page)

The ccusage column follows its README; anything it does not say is left out.

When ccusage is the better choice

  • You only want a terminal report of this one computer, with no account and nothing uploaded.
  • You want open source you can read, and that runs offline.
  • You do not need agents stopped automatically or totals across computers.

Budgethelm's strengths are stopping a stuck agent and seeing several computers together. They do not conflict, and you can install both. For how Budgethelm handles Claude Code, see the Claude Code cost guide.

Other options people compare

  • Claude Code's built-in /usage: nothing to install, shows this computer's usage. See /usage vs Budgethelm.
  • Claude-Code-Usage-Monitor: open source (MIT), a real-time terminal monitor for Claude Code usage with predictions of when you will run out.
  • better-ccusage: open source (MIT), analyzes usage and cost from local JSONL logs of Claude Code, Droid, OpenCode, Codex and other tools.

Based on each project's GitHub description (checked around 2026-10-31); only features they state themselves.

FAQ

Can Budgethelm replace ccusage?
It depends. If you only need a local report, ccusage is enough. Automatic stops for runaway agents, totals across computers and security scans are what Budgethelm adds.
Can I use both?
Yes. Each reads local logs and they do not interfere.
Does Budgethelm upload my conversations?
No. Only time, tool, model, token counts and stop records are uploaded; conversations, code and API keys stay on your computer.