---
title: "ribbon"
url: "https://claudemods.dev/ko/builds/ribbon-64f1c4"
source: "https://github.com/robonuggets/ribbon"
source_type: "github"
repo: "https://github.com/robonuggets/ribbon"
author: "RoboNuggets"
author_handle: "robonuggets"
stars: 252
category: "대시보드 및 HUD"
categories: ["hud"]
tags: ["cost-estimate", "hooks", "prompt-cache", "statusline", "usage-tracking"]
permission_level: 0
scan_complete: true
install: "claude plugin marketplace add robonuggets/ribbon\nclaude plugin install ribbon@robonuggets"
added: "2026-11-19T05:08:49.359Z"
updated: "2026-10-20T01:24:54Z"
locale: "ko"
content_locale: "ko"
---

# ribbon

7일 및 5시간 사용량의 남은 양, 각각의 재설정 시점, 프롬프트 캐시가 웜인지 콜드인지와 다음 메시지의 예상 비용을 프롬프트 위의 얇은 띠로 보여 주는 무료 Claude Code 플러그인입니다.

## Description

ribbon은 무료 Claude Code 플러그인으로, 한 번 설치하면 모든 세션에서 프롬프트 위의 얇은 한 줄로 표시됩니다. 7일 및 5시간 창의 남은 사용량을 재설정 카운트다운과 함께 표시하고, 15% 미만에서는 LOW 경고를 표시합니다. 또한 프롬프트 캐시 상태를 보여 주며, WARM은 남은 분과 다음 메시지 비용을, COLD는 재캐시 가격을 먼저 표시합니다. 펼칠 수 있는 캐시 카드에는 유휴 시간, 캐시된 토큰, 현재 모델이 표시된 상태의 모델별 다음 메시지 비용이 표시됩니다. 와이드, 하프 폭, 좁은 화면 및 일반 터미널 레이아웃에 맞춰 조정되며, 앱 자체의 수치를 읽고 모델을 호출하지 않아 비용 없이 실행되고, MIT 라이선스이며 OFL 글꼴이 내장되어 있습니다.

## Install

```
claude plugin marketplace add robonuggets/ribbon
claude plugin install ribbon@robonuggets
```

## Original 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](#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](LICENSE).

The embedded font is [Outfit](https://github.com/Outfitio/Outfit-Fonts), under the SIL Open Font License 1.1.

Made by Jay E from RoboLabs. Learn more at [RoboNuggets](https://robonuggets.com).

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