Ribbon plugin
A Claude Code plugin draws a band above the prompt with remaining 7-day and 5-hour limits and the prompt cache state
- 247 ★ on the repository
- Last commit
- MIT
Minimal access
Why this level
- The plugin reads Claude Code's own numbers and draws them; it calls neither a model nor the network
- The plugin installs at user level and applies to all projects
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/ribbonDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- The plugin reads Claude Code's own numbers and draws them; it calls neither a model nor the network
- The plugin installs at user level and applies to all projects
This is third-party code. Review the repository files before installing.
What it does
Ribbon adds a thin band above the prompt in Claude Code. It carries two remaining-usage bars: the 7-day window and the 5-hour window, each with its reset time. The bars show what is left, and a LOW flag appears next to a window under 15%. The second part of the band tracks the prompt cache. It keeps a chat cheap to continue for an hour after the last message. WARM shows minutes until it cools and the price of the next message; COLD warns that the next request resends the whole chat and costs more. A Show button opens a card with idle time, tokens in the cache and the next message price on each model, with yours marked YOU. The band adapts to window width, never calls a model, and runs in every session after install with no commands.
Who it is for. Claude Code subscribers who run into weekly and 5-hour limits and want to see the price of the next message in advance.
Good fit when
- The 5-hour limit runs out unexpectedly and you want the remaining amount and reset time in the session itself
- Before replying in a long chat you need to know whether the cache went cold and what the message will cost
- You work across several models and want to compare the next message price on each
- You want an indicator with no commands and no model requests
Not a fit when
- You need spend history by day or project: Ribbon shows only current remainders and cache
- You work in Codex, Cursor or another agent: the plugin is for Claude Code only
- You need a budget that halts the session: the band reports numbers and blocks nothing
Example request
Install the Ribbon plugin so I can see remaining limits and cache state above the promptLimitations
The plugin works only in Claude Code and takes its numbers from the app itself, so the band appears in a new session after install. Remaining usage and cache price follow what Claude Code reports and do not replace the subscription dashboard. The next-message price is calculated from a model price table and stays an estimate. Repository tests cover the drawing logic, and operation in Cursor, Codex or other shells is not claimed. The last commit is from October 2026.
How to disable. Run claude plugin uninstall ribbon and the band disappears in new sessions. No settings file needs a manual edit.
FAQ
What do the 7D and 5H marks show?
The remainder of the 7-day and 5-hour windows. The bars show what is left, and each has a reset time beneath it. A LOW flag appears under 15%.
What do WARM and COLD mean?
WARM is a live prompt cache with minutes remaining and the next message price. COLD means an hour has passed since your last message, so the next one resends the whole chat, and the price is shown first.
Does Ribbon spend tokens?
No: it reads the app numbers and draws them, and never calls a model.
How do I install through /plugin?
In a Claude Code session type /plugin install ribbon --marketplace robonuggets/ribbon, answer y to the marketplace question, pick the user scope and start a new session.
How does the band behave in a narrow window?
It adapts to width: everything fits on one row in a wide window, and elements fold in a narrow one.
Discussion
No questions or reviews yet.
Related
PluginsA Claude Code status line with 5-hour and weekly limit usage, reset countdowns, model and prompt cache lifetime
A Claude Code plugin: a status line with context, 5-hour and 7-day limits, cost and usage of Codex, Gemini and z.ai
An always-on-top widget and a CLI show Claude Code limits for 5 hours and 7 days, token burn and the cost of each turn.
A Claude Code status line showing 5-hour and 7-day quota use plus the pace: whether what is left lasts until the window resets
A Claude Code mod that warms the prompt cache during breaks and shows the rewrite cost before a message goes into a cold session
28 components, up to nine lines and 227 settings: a Claude Code status panel with tokens, cache and session price.
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| Ribbon (this card) | no | 247 | |
| ccstatusline | no | 13,590 | a configurable status line; Ribbon draws a ready band with limits and cache |
| Claude Code Usage Monitor | no | 8,801 | a separate terminal monitor; Ribbon runs inside the Claude Code session |
README in short
The description explains what the band shows: the 7-day and 5-hour remainders and cache state. It then gives three install routes (a link for the agent, an agent command, manual entry), notes on the marks and the cache card, a section on width adaptation and screenshot examples.