Usage meter
PROHow much of the plan is used, in words, with when it resets.
Every shadcn style · one file
v2.0 · Updated Oct 13Live preview
pnpm dlx shadcn@latest add @notchset-pro/usage-meterInstallation
pnpm dlx shadcn@latest add @notchset-pro/usage-meterNeeds your registry key. Every components.json style gets the same files.
Works with React 18.3 or 19 on Tailwind CSS v4, in any shadcn project. What's tested
Styles didn't apply?
The CLI adds the styles to the CSS file named in components.json (tailwind.css). Check that it points at your global stylesheet, that the project uses Tailwind CSS v4, and that the file is imported in your root layout. Installed by hand: paste styles.css into that file.
Usage
Import it and pass your content. The props that matter most are listed next.
Example
"use client";
import { UsageMeter } from "@/components/ui/notchset/blocks/usage-meter";
/* the figures are read against a fixed time, so a server render and the browser agree */
const NOW = new Date("2026-10-22T14:00:00");
const USAGE = { window: 0.62, week: 0.31, windowResetsAt: "2026-10-22T16:10:00", weekResetsAt: "2026-10-26T09:00:00" };
const LOW = { ...USAGE, window: 0.86 };
export default function UsageMeterDemo() {
return (
<div className="flex max-w-[420px] flex-col gap-6">
<UsageMeter usage={USAGE} now={NOW} plan="Plus" context={0.64} />
<UsageMeter usage={LOW} now={NOW} variant="line" onOpen={() => {}} />
</div>
);
}Anatomy
Source
components/ui/notchset/blocks/usage-meter.tsx
This component is included with Pro.
Try the live preview above. Get Pro to install the source.
Props
usage–Usage | nullwhat's used of each window; null when nothing measures it (replies from your own key)
now–Datethe time the figures are read against (pass it, so a server render and the browser agree)
plan–stringthe plan's name, said in the heading
context–numberhow full this chat is against what the model can read at once, 0 to 1
variant"full""full" | "line""line": the composer's quiet line, only when it's low or spent
onOpen–() => voidopens the full meter (from the line)
Show all 7 propsShow fewer
locale–string
For coding agents
Give your coding assistant the Markdown guide instead of screenshots.
Where agents read it
- Guide for this component: https://notchset.dev/md/usage-meter.md
- Every component, for tools without MCP: /llms.txt
- MCP server:
https://notchset.dev/api/mcp(setup)
Changelog
v2.0.0 · 2026-10-13
Released with the Notchset system.
Used in
The same file, at work in a finished app. Open it live and find it on its pages.
Part of a kit
Agent UI. An assistant people trust: ask, pick a model, watch the answer stream in with its receipt, and approve what it does.
4 free · 6 ProSee the Agent UI kit
Part of
Included with Pro
Pro is in early access.
