Token Usage Meter

LLM token usage meter showing tokens used against a monthly limit, a labelled progress bar and a percent of budget note with the reset date. Useful in AI apps.

src/registry/ui/token-usage-meter.tsx/r/token-usage-meter.json

Installation#

bash

npx shadcn@latest add @minidev/token-usage-meter

MiniDev UI is in the shadcn registry directory, so the short form works with no setup. Older CLI versions can use the full URL: npx shadcn@latest add https://ui.minidev.pro/r/token-usage-meter.json

Usage#

tsx

import { TokenUsageMeter } from "@/components/ui/token-usage-meter"

export function Example() {
  return (
    <TokenUsageMeter used={4200} limit={10000} />
  )
}

API reference#

TokenUsageMeter props
Prop	Type	Default
`used`	`number`	`128_400`
`limit`	`number`	`200_000`
`className`	`string`	`-`

Dependencies#

npm

React only

Built from

Examples#

AIChat, prompts, streaming

Agent TraceReact timeline of an AI agent run: each tool step shows pending, running, done or error, reports its duration and folds out details. The header sums up the run.Ai ComposerChat input for AI apps with a multiline textarea, Enter to send, suggestion chips, attach button, model picker and a stop button while a response streams.Artifact PreviewFramed preview for AI generated artifacts such as code, documents or UI, with a title bar, copy button and optional expand action for a full view.Attachment ChipCompact Tailwind file chip with a paperclip icon, truncated filename and an optional remove button, for attachments in chat composers, emails and forms.Chat ThreadScrolling chat thread for React that renders user, assistant and system messages as bubbles, auto scrolls to the newest one and uses a live log role.Citation ChipInline citation button for AI answers, with an accent source number and label. Link it to a source panel or popover so users can check references.

All AI chat UI components for React