Ribbon

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.

One row. That's the whole footprint.

Install

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

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:

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:

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…