For AI Agents
Hand your agent this brief or the ReUI MCP, not a screenshot. Installs with a ReUI Pro or Ultimate license.
Best for: A self-serve page where a workspace admin sets next month's token volume, model and add-ons and sees the bill against a budget
When to use
- A self-serve planner where an admin sets next month's token volume, model and add-ons against a budget
- A month to date breakdown of AI spend by model, team, agent and API key, with the caps at risk
- A budget, run rate or volume discount readout inside an AI product's own account area
When not to use
- Public plan tiers and an upgrade path on a public site, with no usage to plan: use the Pricing blocks
- Staff back office for invoices, subscriptions, dunning and metered charges: use the Billing blocks
- An operator console for provider health, routing and quotas across an org: use the AI Ops blocks
Agent notes
- Bands, models, add-ons and the budget live in
TIERS,MODELS,ADDONSandBUDGET; every figure in the spend panel comes frombuildQuote - Each
TIERSband edge must be an exact value inSTOPS, the slider's 81 steps from 1M to 10B, or the band row loses its place onSaveandonContactonly fire a sonnertoast, seen once your app mounts a Toaster; send the plan to your billing API thereAiUsagetakes no props and calls no API; every figure comes from typed constants in components/data.tsx, so swap them for your data- Money prints through en-US USD helpers such as
formatDollarsin formatters.ts, so another currency starts there
Third-party API docs
- Motion v12: API reference, docs (the docs follow the latest Motion, with no React API break since v12)
- Sonner v2: API reference, docs
https://reui.io/blocks/ai-agents/ai-usage/ai-usage-1.mdget_block("ai-usage-1")npx shadcn@latest add @reui/ai-usage-1Shadcn Components in the Usage Planner Block
Dependencies
- cn
- motion
- sonner
Shadcn Usage Planner Block
Usage planner with a stepped token ruler, model cards and a live spend estimate. Part of the ReUI Shadcn AI & Agents AI Usage blocks collection.
Plan next month's AI spend: a stepped token ruler with graduated volume discounts, model cards, add-on chips and a projected total against a monthly budget. ReUI Frame, Badge; shadcn Slider, RadioGroup, ToggleGroup, Switch, DropdownMenu, Tooltip; Motion. Usage pricing, AI billing.
It is composed from Avatar, Badge, Button, Dropdown Menu, Field, Frame, Radio Group, Separator, and more, so every part of it is a primitive you can restyle with your own design tokens.
What You Can Build With the Usage Planner Block
- Install it with the ReUI registry command in the toolbar above, then swap the placeholder content, data wiring, and business logic for your own.
- Compare it across all eight ReUI styles and both the Base UI and Radix bases in the customizer before committing to one direction.
- Combine it with the other Shadcn AI & Agents AI Usage blocks to assemble a full screen instead of a single section.
All Shadcn AI & Agents AI Usage Blocks
The rest of this category, each on its own page with a live preview, the components it is built from, and the install command.
- Spend Map Spend map that fans monthly AI spend out by model, team, agent and API key
Related Shadcn AI & Agents Block Categories
- AI Chat (13) Conversation surfaces for AI products, from full chat shells to embeddable threads, sheets, and launchers.
- Agent Activity (5) Agent run views, from live step feeds and approvals to research traces, MCP call tables, and run reports.
All Shadcn Block Groups
Browse the full ReUI Shadcn blocks library by product surface. Each group bundles category-level blocks you can mix and match across your project.
- Shadcn Application Blocks (303) Browse 303 Shadcn Application blocks across 23 categories.
- Shadcn Data Grid Blocks (44) Browse 44 Shadcn Data Grid blocks across 9 categories.
- Shadcn Charts Blocks (51) Browse 51 Shadcn Charts blocks across 10 categories.
- Shadcn Solutions Blocks (76) Browse 76 Shadcn Solutions blocks across 11 categories.
- Shadcn AI & Agents Blocks (20) Browse 20 Shadcn AI & Agents blocks across 3 categories.
- Shadcn eCommerce Blocks (87) Browse 87 Shadcn eCommerce blocks across 13 categories.
- Shadcn Marketing Blocks (67) Browse 67 Shadcn Marketing blocks across 8 categories.
Frequently Asked Questions
When should I use the Usage Planner block?
Use it for a self-serve page where a workspace admin sets next month's token volume, model and add-ons and sees the bill against a budget.
The AI Usage category fits:
- A self-serve planner where an admin sets next month's token volume, model and add-ons against a budget
- A month to date breakdown of AI spend by model, team, agent and API key, with the caps at risk
- A budget, run rate or volume discount readout inside an AI product's own account area
For public plan tiers and an upgrade path on a public site, with no usage to plan, use the Pricing blocks. For staff back office for invoices, subscriptions, dunning and metered charges, use the Billing blocks. For an operator console for provider health, routing and quotas across an org, use the AI Ops blocks.
What is the Usage Planner block built with?
Can I restyle the Usage Planner block?
How should I use Shadcn ai usage blocks in a real project?
Start building with ReUI Pro today.
Every Pro block, every style, and every future addition, with one license for unlimited projects.
From $249, once. Lifetime updates.