tare README

The project's README from github.com/kelviq/tare. As one markdown file: README.md.

tare

Ask Claude Code where your usage went.

You hit a usage limit and don't know why. Your quota drains faster than it used to. You suspect something is eating tokens in the background. The records that answer all of this are already on your computer — Claude Code keeps a log of every request it makes. tare teaches Claude Code to read its own logs, so you can just ask.

No dashboards, no commands to learn. Install once, then ask in plain English.

Tare: the weight of the container, subtracted to find what's inside. Most of what a session costs is the container — context re-sent again and again — and that's exactly what these tools subtract.

Read full story - https://www.kelviq.com/blog/claude-code-usage-limits-where-tokens-go/

Install

One command, in any terminal:

npx skills add kelviq/tare -g -y --copy --agent claude-code

That's it. Nothing else to set up — no accounts, no packages, no configuration. Start a new Claude Code session and it's live — type / and check that tare appears. If it doesn't, see the troubleshooting note — on machines where Claude Code has never installed a skill before, the installer can miss it. (Other ways to install — by hand, for a whole team, or as a Claude Code plugin — are in INSTALL.md.)

Then just ask

Open Claude Code and ask your question the way you'd ask a person. These all work — the words don't have to match, complaining about your limits is enough:

When you hit a limit

Why did I hit my usage limit yesterday?

I got locked out ten minutes into my evening session — how is that possible?

Did I hit the 5-hour limit or the weekly cap?

Why am I burning through my quota so much faster this week?

Where your tokens go

Where did my tokens actually go this week?

Which of my projects is eating my quota?

Which model is costing me the most?

What's the most expensive file Claude keeps re-reading?

How much did that giant session yesterday actually cost me?

Are my MCP servers adding a lot to my context?

How much overhead do subagents and skills add?

Before you start something big

How full is my 5-hour window right now?

Is it safe to start a big refactor now, or should I wait for my window to clear?

Checking for things you forgot

Is something running Claude Code in the background?

Was Claude Code active while I was asleep?

I set up an automation last month — what is it costing me?

Tuning your setup

I started using /clear between tasks — did it actually help? Compare this week to last.

Did the latest Claude Code update change my usage?

What would my usage cost if I were paying for the API directly?

What one change would save me the most?

Reports and sharing

Make me a usage report I can open in my browser.

Give me a summary I can post publicly — with nothing private in it.

Export my usage to a spreadsheet.

Prefer typing commands? /tare runs the full diagnosis, and takes variants for the common asks — asking in plain words always works too:
/tare full diagnosis — where tokens went and why
/tare usage at-a-glance panel — like /usage, with attribution
/tare window how full is the 5-hour window — safe to start?
/tare report [days] build the HTML report and open it
/tare tools [days] what is filling my context
/tare week compare this week with last
/tare share [days] redacted summary safe to post publicly
/tare why did I hit the limit yesterday any question works as the argument
image

What you get back

Not a wall of numbers — a cause. The answer to "why did I hit my limit yesterday?" looks like this:

99% of yesterday's usage came from a tool you're running, not from you. Something spawned 1,553 short Claude Code sessions in your website project — 9,022 requests, up to 51 sessions running at once. Your own hands-on work that day was 93 requests. Each fresh session rebuilds its context from scratch, which is the most expensive way to spend tokens...

...followed by the evidence, what to check, and what to change. And when everything is actually fine, it says that: usage proportionate, no anomaly, here's what's normal for you.

Real output lives in examples/ — a shareable summary produced by /tare share, and the HTML report.

What it knows that a raw token count doesn't

Private by design

Everything runs on your machine and nothing leaves it. The scripts make no network connections at all. When you ask for a shareable summary, it contains totals, dates and tool names only — no prompts, no file paths or contents, no commands, no session or account identifiers — so you can post it publicly or send it to a colleague and ask "what am I missing?"

Don't take that on faith: SECURITY.md states exactly what each file reads, writes and sends, and shows how to verify every claim yourself with one grep.

Requirements

Demo

https://github.com/user-attachments/assets/358ecacb-972b-4452-9633-e530af3d5490

For developers

Everything the skill does, you can also do by hand: three dependency-free Python scripts with recipes for scripting, cron, CSV export, live per-request telemetry and more — see CLI.md.

Issues and PRs welcome. Useful directions: a live TUI, Windows paths, aggregating anonymised summaries across users to spot patterns no single person can see, and better token estimation for tool results.

MIT licensed.

tare (kelviq/tare)

Searching Database…

296 ·GitHub
Tare
What is this?tare is a tool that lets you ask Claude Code in plain English where your token usage went, diagnosing why you hit a usage limit by reading the session logs Claude Code already keeps on your machine.
Is this a Claude Code skill or a separate app with a dashboard?It is a Claude Code skill (plus optional standalone Python scripts for developers) — there is no dashboard or new commands to learn; you just install it and ask Claude Code questions directly.
Do I need Python or any packages set up first?You need Claude Code on macOS or Linux and Python 3.9+, which is already preinstalled on every Mac, so there is nothing extra to install.
Does it work with other coding agents or on Windows?No — it currently only reads Claude Code's own logs, not those of other coding agents, and Windows support is listed only as a future direction, not something that works today.
Can I run this on Windows right now?Not yet — it's built and supported for Claude Code on macOS or Linux only; Windows paths are an open improvement area, not a current feature.
Does any of my usage data leave my machine?No, everything runs locally and the scripts make no network connections at all; shareable summaries only include totals, dates and tool names, never prompts, file paths or account identifiers.
What slash commands does tare provide?'/tare' runs a full diagnosis, with variants like '/tare usage' for an at-a-glance panel, '/tare window' to check how full your 5-hour limit window is, '/tare report' to build an HTML report, and '/tare share' for a redacted public summary.
Why can't I just trust the token counts Claude Code already shows?Claude Code's log format repeats each API response multiple times, which inflated raw totals by 86% on the data tare was tested against; tare deduplicates the logs to get correct numbers.
Can I verify tare's privacy claims myself instead of just trusting them?Yes — SECURITY.md documents exactly what every file reads, writes and sends, and shows a one-line grep you can run to verify the claims yourself.
What does the name 'tare' mean?Tare is the weight of a container subtracted to find what's actually inside — a metaphor for stripping out the repeated context overhead that dominates most session costs.
What are similar projects?ccusage, AgentMeasure, codeburn, casbin-gateway, cost-xray, ThinkWatch-Lite, CodexBar, token-monitor
Which topics is it in?usage-tracking, cost-tracking, token-usage, privacy-first, analytics, observability, offline, monitoring, local-first, command-line-tool, privacy, claude-code
Creator
kelviq
Size
0.1 MB
Stars
296
Updated
CommitAug 28
Age
2mo
Commits · 90 Days