Privacy Policy

Last updated 4 August 2026.

Summary

Claude Usage runs entirely on your Mac. It reads files Claude Code has already written, and makes exactly two kinds of network request: one authenticated call to Anthropic for your own usage limits, and an unauthenticated check to GitHub for a newer release. There is no analytics, no account, no server of ours, and no third party involved.

What it accesses, locally on your device

• Your Claude credential token. To read your live usage limits, the app reads the access token Claude Code already stores: the login Keychain item Claude Code-credentials, or .credentials.json inside a config folder. macOS asks your permission the first time. The token is used only as the bearer credential on the request below; it is never copied, logged, or written anywhere.
• Your local Claude Code transcripts. For token counts and cost, the app reads the JSONL conversation logs under <config folder>/projects/. It parses them read-only and keeps only totals — token counts, computed cost, the request ids it uses to avoid double-counting, and each entry's working directory, which is where project names come from. Message content is never read into anything it keeps.
• Which config folders exist. To offer a profile per widget, it lists ~/.claude and folders beside it whose names begin with .claude, treating any that contains a projects directory as an account. For each it reads the account email, organization name and plan tier from that folder's .claude.json, purely to label the picker.
• Your settings. Thresholds, the selected profile, and the optional User-Agent are stored in the app's own preferences on your Mac.

What it transmits

• One authenticated GET to Anthropic. To api.anthropic.com/api/oauth/usage, about once a minute, carrying your Claude token so Anthropic can tell you your own limits. Nothing about your transcripts, projects, machine or settings is included. Anthropic's handling of that request is covered by their privacy policy.
• One unauthenticated GET to GitHub. To api.github.com, four times a day, to ask for this project's latest release tag. It carries no token, no account, and no identifier — just the request itself, which necessarily reveals your IP address to GitHub as any web request would. You can switch it off in Settings under Updates.

That is the complete list. There is no telemetry, no crash reporting, and no analytics of any kind.

What it stores

• Daily usage totals, in ~/Library/Application Support/ClaudeUsage/history.json. Just a date, a token count and a cost per day, kept so your chart outlives the transcripts themselves — Claude Code prunes those after about a month. One file per profile.
• A snapshot of the current figures, written where the widget can read it. This is the same numbers you see on screen.
• Your settings, in the app's preferences.

All of it stays on your Mac. Deleting the app and the ClaudeUsage folder in Application Support removes everything it ever wrote — or run brew uninstall --zap --cask claude-usage.

Data sharing

None. Nothing is sold, shared, or sent to us — we do not operate a server and could not receive your data if we wanted to.

Children

The app is a developer tool and is not directed at children under 13. It collects nothing from anyone.

Changes to this policy

Any change will be published here and noted in the release notes. The source is public, so the behaviour described above can be verified rather than taken on trust.

Contact

Questions or concerns: open an issue.