ClaudeMods
☰
ZH-TW
● — 人在線上 · 瀏覽 — 次
贊助提交作品
GitHub 儲存庫 · 發布者 RoboNuggets

ribbon

一款免費的 Claude Code 外掛,在提示詞上方加入一條細窄列,顯示你的 7 天與 5 小時用量還剩多少、各自何時重設,以及提示詞快取是熱還是冷,並附上下下一則訊息的預估費用。

已翻譯

關於這個 mod

ribbon 是一款免費的 Claude Code 外掛,安裝一次後就會在每個工作階段中顯示為提示詞上方的一條細窄列。它會顯示 7 天與 5 小時視窗的剩餘用量及重設倒數,並在低於 15% 時顯示 LOW 警告;還會顯示提示詞快取狀態:WARM 顯示剩餘分鐘數與下一則訊息費用,COLD 先顯示重新快取的價格。可展開的快取卡片會顯示閒置時間、已快取 token 數,以及依模型列出的下一則訊息費用,並標記你目前的模型。它適應寬版、半寬、窄版與純終端機版面,透過讀取應用程式自身的數值且從不呼叫模型,因此零成本運作,並採用 MIT 授權,內嵌 OFL 字型。

安裝

請先查看作者 README,確認 marketplace 與外掛名稱;指令可能隨儲存庫結構而變動。

claude plugin marketplace add robonuggets/ribbon
claude plugin install ribbon@robonuggets
原文 / README
<p align="center"> <img src="assets/banner.png" alt="ribbon" width="100%"> </p>

ribbon

A free mod for Claude Code. It adds a slim band above your prompt that shows:

  • How much usage you have left in your 7-day and 5-hour windows, and when each one resets.
  • Whether your prompt cache is warm or cold, and what your next message will cost.

It installs once and is there in every session after that. No commands to learn.

<p align="center"> <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%"> </p> <p align="center"> <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%"> </p>

One row. That's the whole footprint.

Install

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 you see

Usage left

  • 7D (orange) is your 7-day window. 5H (yellow) is your 5-hour window.
  • Each dot bar shows what is left, not what is used.
  • Under each one is when it resets, for example resets 3d 9h.
  • If a window drops under 15%, a bold LOW shows next to it.

The prompt cache

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.

  • WARM (red, the robot bobs): the cache is live. It shows the minutes left and what your next message costs.
  • 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.

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.

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 below.

Fits any width

  • Wide: everything on one row.
  • Half width: each window stacks into a small block.
  • Narrow: the cache moves to its own row.
  • Terminal: the same facts as plain text.

Good to know

  • It costs nothing to run. It reads the app's own numbers and draws them. It never calls a model.
  • 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.
  • Subagents don't count. Only your main chat resets the cache clock.

What is inside

ribbon/
├── .claude-plugin/
│   ├── plugin.json         the mod's name and version
│   └── marketplace.json    makes this repo installable
├── hooks/
│   ├── hooks.json          points to the module
│   ├── register.tsx        the band: usage, cache tracking, layout
│   ├── cache-art.ts        the cache card and robot drawings, the price table
│   └── font.ts             Outfit, embedded so the drawings render anywhere
├── types/index.d.ts        the shape of what the band remembers
├── tests/                  7 tests: layouts, warm and cold, terminal, cleared sessions
└── assets/                 banner, screenshots, hex icon

Remove it

claude plugin uninstall ribbon

Develop it

Load the folder without installing it:

claude --plugin-dir ./ribbon

Run the tests:

claude plugin test ./ribbon

Up close

Click Show and the band opens into the cache card.

Warm. The cache is live. Your next message is cheap.

<p align="center"> <img src="assets/detail-warm.png" alt="Warm cache card: 6m idle, 245k tokens in cache, next message $0.05 on Opus" width="100%"> </p>

Cold. The hour has passed. Your next message re-sends the whole chat, so it costs more.

<p align="center"> <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%"> </p>

License

MIT.

The embedded font is Outfit, under the SIL Open Font License 1.1.

Made by Jay E from RoboLabs. Learn more at RoboNuggets.

<p align="center"> <img src="assets/hex.svg" alt="RoboNuggets hex mark" width="48"> </p>

取得徽章

這是你的專案嗎?把這個徽章放進 README 或網站,連回本頁。

Featured on ClaudeMods
尺寸
配色
Markdown
HTML

更多類似作品