My open source project · Plugin for Obsidian
Token Usage
Do you actually know your Claude limit? My plugin for Obsidian shows it to you, using nothing but your own data.
My plugin Token Usage reads the session files Claude Code already writes on your machine and shows usage, the five-hour windows and the weekly limit right in the Obsidian sidebar. It needs no API key and no cloud.

These are sample data, not real usage figures.
Why I built this
Anthropic keeps most details about tokens to itself, but the details are on your own disk.
Anthropic, like most other large AI providers, does not publish how many tokens sit behind a limit. Up to version 2.1, Token Usage turned your own limit hits into an estimate, and measured against the official values it was off by 36 points on average for the five-hour window (own measurement, 37 readings, October 2026). So since 2.5 the plugin shows a percentage for Claude Code, also in the Agent Mode of the Claude Desktop App, only when it comes from Anthropic itself, always with the time of the reading.
Everything else is counted instead of estimated: your tokens in the current window and in the week, the time to the reset, and the span at which your window has filled up so far. The span is wide, and that is the honest answer.
An estimate that is off by 36 points on average helps nobody, so since 2.5 I only show what Anthropic itself reports. More in the changelog →
What the plugin does
One glance is enough, the dashboard offers more content and detail.
Three gauges, one heatmap
The current five-hour window and the current week show the official percentage from Anthropic with the time of the reading, today a multiple of your usual day. Below it, the heatmap of your billing week in two-hour cells.
- The five-hour window opens with your first message and runs exactly five hours.
- The weekly reset comes from the official feed or from your own history and follows daylight saving. In the tool I use all the real data available that Anthropic stores locally for this.
- Today is compared with your own average, not with a theoretical daily limit that demonstrably does not exist.

Compare projects and vaults
The HTML dashboard shows a forecast, the limits and model distribution. In the Projects tab you see which vault or project causes how much usage, down to the subfolders. This also makes project billing possible.
Handy when you work for several clients and want to attribute usage.

Your numbers are yours
Projects, daily detail and key figures can be exported as CSV, three files in a format Excel opens right away. The daily values are also archived in your vault, beyond the retention period of Claude Code.

What the plugin deliberately leaves out
It reads along, and nothing else happens.
Nothing leaves your machine
No network requests, no telemetry, no server. Every number is calculated locally.
Read only
The plugin reads the session files of Claude Code. New files are created only in your own vault: the daily archive and, when you trigger it, report, dashboard and export. Prompts and responses are in none of them.
Open to inspect
The source code is on GitHub under the MIT license, and the release files carry a verifiable provenance attestation.
Status and outlook
What is new right now and what I plan next.
- Percentages from Anthropic only, with the time of the reading, the week carried forward in between and labelled as projected.
- Without the feed the plugin shows counted tokens, the time to the reset, and the span at which your five-hour window has filled up so far.
- Two security gaps closed that we found ourselves (dashboard and CSV export), plus a weekly reset that follows daylight saving.
- Under reviewOfficial readings without a status line, without each reading costing a small request of its own.
- Under reviewCount and show the share of requests with a large context, the way /usage lists it since October 2026.
- PlannedScreenshots of the current interface in the documentation, in all five languages.
- PlannedTotal tokens since recording began, with a note that the total only reaches back as far as Claude Code's logs and the daily archive.
Whether something ships depends on what my data supports. None of this is a firm promise.
Installation
Set up in three steps.
- Find the plugin. In Obsidian go to Settings, Community plugins, Browse and search for
Token Usage. - Install and enable. The icon then appears in the left ribbon and the sidebar opens.
- Use Claude Code. The plugin reads the existing session files, so you see numbers after your first session.
Requirements: Obsidian 1.4.0 or later on the desktop and Claude Code on the same computer. Tested on Windows and macOS.
Background
Built out of my own need for a clearer overview.
I wanted a fuel gauge for my work with Claude Code and found none that sits where I work. So I built one myself with Claude Code, really just for me. It has since been downloaded more than 1,000 times. The story is on my blog, along with the mistakes I made in the process.