Skip to content
Back to search

robonuggets

MarketplaceWorks with Claude CodeGitHub

A slim band above your Claude Code prompt: usage left, reset times, and whether the prompt cache is warm or cold. By Jay E | RoboNuggets

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/robonuggets--ribbon/badge.svg)](/listings/robonuggets--ribbon)

HTML

<a href="/listings/robonuggets--ribbon"><img src="/api/listings/robonuggets--ribbon/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

The easy way: send this link to your agent and say "install this".

https://github.com/robonuggets/ribbon

Your agent runs one command. The band shows up in your next session.

For agents

If you are an agent and your user asked you to install this, run this in a shell:

claude plugin install ribbon --marketplace robonuggets/ribbon

It installs for the user (all their projects) and adds the marketplace on its own. Then tell your user: "Ribbon is installed. Start a new session to see the band above your prompt." Do not edit their settings file by hand.

By hand

In a Claude Code terminal session, type:

/plugin install ribbon --marketplace robonuggets/ribbon

1. Type `y` when it asks `Add marketplace?`. 2. Pick the **user** scope with Enter. 3. Start a new session.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 11 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "robonuggets",
  3. "owner": { "name": "Jay E", "url": "https://robonuggets.com" },
  4. "plugins": [
  5. {
  6. "name": "ribbon",
  7. "source": "./",
  8. "description": "A slim band above the prompt: usage left, reset times, and whether the prompt cache is warm or cold with what the next message costs."
  9. }
  10. ]
  11. }
README.md · README · 152 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <img src="assets/banner.png" alt="ribbon" width="100%">
  3. </p>
  4. # ribbon
  5. A free mod for Claude Code. It adds a slim band above your prompt that shows:
  6. - **How much usage you have left** in your 7-day and 5-hour windows, and when each one resets.
  7. - **Whether your prompt cache is warm or cold**, and what your next message will cost.
  8. It installs once and is there in every session after that. No commands to learn.
  9. <p align="center">
  10. <img src="assets/slim-warm.png" alt="ribbon, one slim row: 7D 41% left, 5H 96% left, cache warm with 53 minutes left" width="100%">
  11. </p>
  12. <p align="center">
  13. <img src="assets/slim-cold.png" alt="ribbon, one slim row: 7D 45% left, 5H 89% left, cache cold for 12h 45m, next message $4.78" width="100%">
  14. </p>
  15. One row. That's the whole footprint.
  16. ## Install
  17. The easy way: send this link to your agent and say "install this".
  18. ```
  19. https://github.com/robonuggets/ribbon
  20. ```
  21. Your agent runs one command. The band shows up in your next session.
  22. ### For agents
  23. If you are an agent and your user asked you to install this, run this in a shell:
  24. ```
  25. claude plugin install ribbon --marketplace robonuggets/ribbon
  26. ```
  27. It installs for the user (all their projects) and adds the marketplace on its own. Then tell your user: "Ribbon is installed. Start a new session to see the band above your prompt." Do not edit their settings file by hand.
  28. ### By hand
  29. In a Claude Code terminal session, type:
  30. ```
  31. /plugin install ribbon --marketplace robonuggets/ribbon
  32. ```
  33. 1. Type `y` when it asks `Add marketplace?`.
  34. 2. Pick the **user** scope with Enter.
  35. 3. Start a new session.
  36. ## What you see
  37. ### Usage left
  38. - **7D** (orange) is your 7-day window. **5H** (yellow) is your 5-hour window.
  39. - Each dot bar shows what is **left**, not what is used.
  40. - Under each one is when it resets, for example `resets 3d 9h`.
  41. - If a window drops under 15%, a bold **LOW** shows next to it.
  42. ### The prompt cache
  43. After your first reply, the band also tracks the prompt cache. The cache keeps your chat cheap to continue for one hour after your last message.
  44. - **WARM** (red, the robot bobs): the cache is live. It shows the minutes left and what your next message costs.
  45. - **COLD** (blue, the robot is frozen): the hour has passed. Your next message re-sends the whole chat, so it costs more. It shows the price first.
  46. Click **Show** to open the cache card, and **Hide** to fold it. Warm starts folded. Cold starts open, so you see the price before you send.
  47. The card shows how long you've been idle, how many tokens are in the cache, and what the next message costs on each model. Your model is marked **YOU**. See [Up close](#up-close) below.
  48. ### Fits any width
  49. - **Wide:** everything on one row.
  50. - **Half width:** each window stacks into a small block.
  51. - **Narrow:** the cache moves to its own row.
  52. - **Terminal:** the same facts as plain text.
  53. ## Good to know
  54. - **It costs nothing to run.** It reads the app's own numbers and draws them. It never calls a model.
  55. - **Prices are estimates.** They come from a price table in `hooks/cache-art.ts` (`MODELS`), not from your bill. If prices change, edit that table.
  56. - **Subagents don't count.** Only your main chat resets the cache clock.
  57. ## What is inside
  58. ```
  59. ribbon/
  60. ├── .claude-plugin/
  61. │ ├── plugin.json the mod's name and version
  62. │ └── marketplace.json makes this repo installable
  63. ├── hooks/
  64. │ ├── hooks.json points to the module
  65. │ ├── register.tsx the band: usage, cache tracking, layout
  66. │ ├── cache-art.ts the cache card and robot drawings, the price table
  67. │ └── font.ts Outfit, embedded so the drawings render anywhere
  68. ├── types/index.d.ts the shape of what the band remembers
  69. ├── tests/ 7 tests: layouts, warm and cold, terminal, cleared sessions
  70. └── assets/ banner, screenshots, hex icon
  71. ```
  72. ## Remove it
  73. ```
  74. claude plugin uninstall ribbon
  75. ```
  76. ## Develop it
  77. Load the folder without installing it:
  78. ```
  79. claude --plugin-dir ./ribbon
  80. ```
  81. Run the tests:
  82. ```
  83. claude plugin test ./ribbon
  84. ```
  85. ## Up close
  86. Click **Show** and the band opens into the cache card.
  87. **Warm.** The cache is live. Your next message is cheap.
  88. <p align="center">
  89. <img src="assets/detail-warm.png" alt="Warm cache card: 6m idle, 245k tokens in cache, next message $0.05 on Opus" width="100%">
  90. </p>
  91. **Cold.** The hour has passed. Your next message re-sends the whole chat, so it costs more.
  92. <p align="center">
  93. <img src="assets/detail-cold.png" alt="Cold cache card: 16h 8m idle, 243k tokens to re-cache, next message $1.94 on Opus" width="100%">
  94. </p>
  95. ## License
  96. [MIT](LICENSE).
  97. The embedded font is [Outfit](https://github.com/Outfitio/Outfit-Fonts), under the SIL Open Font License 1.1.
  98. Made by Jay E from RoboLabs. Learn more at [RoboNuggets](https://robonuggets.com).
  99. <p align="center">
  100. <img src="assets/hex.svg" alt="RoboNuggets hex mark" width="48">
  101. </p>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.