SkillAgentSearch skills...

cache-maxxing

A bar above your chat to see when Claude's prompt cache expires, and what your next message will cost, before you send it.

Install / Use

npx skills add 5m0k3/cache-maxxing

Installs into whichever agent you are using.

About this skill
πŸ“„

SKILL.md

Installable skill definition

Quality Score

84/100

Supported Platforms

Claude Code

Our assessment of cache-maxxing

cache-maxxing scores 84/100 on our quality scale, 2784th of 4,716 Development & Engineering skills we index.

Its SKILL.md is 9.2 KB long, well organised into 13 sections with 2 code examples: a thorough specification that gives an agent plenty to work with.

It has 45 GitHub stars, so there is little community track record yet; judge it on its content.

Substance
29/30
Structure
18/20
Description
15/15
Adoption
7/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated today, so cache-maxxing is actively maintained.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 97/100, with no cautions. These come from repository metadata, not a code audit β€” read the skill file before letting an agent act on it.

cache-maxxing compared with similar skills

All 4 of these similar skills score higher than cache-maxxing; compare them before choosing.

SkillScoreStarsUpdatedFormat
cache-maxxing (this skill)by 5m0k38445todaySKILL.md
taste-skillby Leonxlnx100118.9k11d agoCLAUDE.md
hyperframesby heygen-com10087.1ktodayCLAUDE.md
rufloby ruvnet10082.1ktodayCLAUDE.md
headroomby headroomlabs-ai10080.2ktodayCLAUDE.md

Frequently asked questions

How do I install cache-maxxing?
Run npx skills add 5m0k3/cache-maxxing. The install tabs above show the steps for each supported agent.
Which AI agents does cache-maxxing work with?
It is written for Claude Code, as a SKILL.md file. Other agents that read the same format can often use it too.
Is cache-maxxing safe to use?
It is MIT-licensed and scores 97/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is cache-maxxing still maintained?
The repository was last updated today, so cache-maxxing is actively maintained.
<div align="center"> <img src="assets/icon.png" alt="cache-maxxing icon" width="120" height="120">

cache-maxxing

See when Claude's prompt cache expires, and what your next message will cost, before you send it.

version license: MIT Claude Code plugin

</div>

About

Ever feel like your Claude subscription quota disappears way faster than it should? Usually, it's not how much you're building - it's when you hit Send.

Claude keeps your chat "warm" only for a while so follow-up messages barely dent your limit. But wait too long between messages, and Claude has to re-read your entire chat history at full cost - up to 80Γ— more quota than a normal reply.

cache-maxxing puts an easy-to-read bar right above your chat box (in the desktop app, VS Code, and terminal) to protect your quota while you build:

  • Know before you hit Send: See a live countdown timer and whether your next message is cheap (🟒), running out of time (🟑), or about to take a huge bite out of your limit (πŸ”΄).
  • Never lose your flow with /cmaxx-handoff: When a long chat gets too expensive to continue, run one command to hand off a smart summary of your progress into a fresh chatβ€”no re-explaining your project, and no massive quota spike.
  • Zero setup headaches, zero slowdown: Everything is calculated right on your machine using numbers Claude Code already tracks. The bar sends nothing anywhere.

| | | |---|---| | <img src="assets/screenshots/desktop_green.png" alt="Green bar: cache active, next message cheap" width="420"> | <img src="assets/screenshots/vscode_yellow.png" alt="Yellow bar: cache ending soon" width="420"> | | 🟒 Cache active. Messages are cheap right now. | 🟑 Ending soon. The cheap moment to reply. | | <img src="assets/screenshots/desktop_red.png" alt="Red bar: cache expired, with what a handoff saves" width="420"> | <img src="assets/screenshots/cli_orange.png" alt="Orange bar: cache expired, but the rebuild is cheap" width="420"> | | πŸ”΄ Expired. What a rebuild costs, and what a handoff saves. | 🟠 Expired. But the rebuild cost is low. |

Features

| | | |---|---| | ⏱️ Live countdown | Minutes left on the cache, ticking every second; it survives restarts, sleep and switching chats. | | πŸ’² Next-message cost | In dollars (API prices) or as "Γ— more" (better for subscriptions), plus how full the chat is (290K / 1M). | | 🚦 One clear tip | 🟒 keep going Β· 🟑 reply soon Β· 🟠 expired small chat, fine Β· πŸ”΄ expired, with what a handoff would save. | | πŸ”” One pop-up | A single warning when a big chat's cache expires, and a heads-up if you send into it. Your message is never stopped. | | πŸ”„ /cmaxx-handoff | Haiku (effort: High) writes a briefing of the chat; a fresh chat picks up from it. The expired chat is never resent to the main model. | | πŸ“Š /cmaxx-stats | Money and tokens saved, cache hit rate, rebuilds paid: for this chat and for all chats. | | ⬆️ /cmaxx-update | Updates the plugin, or at least its model and price list, so new models are priced on day one. | | πŸ”’ Local by default | No network and no model calls, except the two commands above, and only when you run them. |

Install

Requires a recent Claude Code: the desktop app, the VS Code extension, or the CLI. It's tested on 2.1.325 and later.

Any application
Just paste this repository's link (https://github.com/5m0k3/cache-maxxing) in the chat window and ask Claude to install it for you.

or see below for your specific application:

Desktop app

  1. Click + next to the chat box, then Plugins β†’ Manage Plugins.
  2. On top right press + Add β†’ Add marketplace β†’ Add from a repository and enter 5m0k3/cache-maxxing.
  3. Add plugin β†’ cache-maxxing.

Terminal or VS Code (at the Claude Code prompt)

/plugin install cache-maxxing --marketplace 5m0k3/cache-maxxing

Answer y to add the marketplace and press Enter for the user scope. The bar shows after your next message (may need a restart).

Usage

| Command | What it does | |---|---| | /cmaxx | Hide or show the bar in this chat (the βœ• on the bar hides it too). | | /cmaxx-handoff | Write a briefing of this chat with Haiku and start a fresh chat from it. (Doesn't trigger the old chat's model) | | /cmaxx-stats | Show savings, cache hit rate, rebuilds and replies: this chat and all chats. | | /cmaxx-update | Update to the latest version, or refresh the model and price list. |

What each light means, the exact texts and the rules behind them: How the bar decides.

Settings

In the plugin's settings, under cache-maxxing:

| Setting | Default | What it changes | |---|---|---| | Rebuild limit ($) | 0.50 | Above this rebuild cost, the bar suggests a handoff instead of carrying on. | | Warning time (minutes) | 15 | How early the bar turns 🟑 before the 1-hour cache expires. | | Long chat size (tokens) | 300000 | When the 🟒 bar starts suggesting a handoff once you're done. | | Show cost as | dollars | times shows "40Γ— more" instead of dollars, which suits subscription plans. | | Memory time | auto | auto is 1 hour (every Claude subscription chat). Choose 5 with an API key. |

Keep it updated

Plugins from GitHub don't update by themselves: Claude Code auto-updates only Anthropic's own marketplaces by default.

  • Once: in a terminal session, /plugin β†’ Marketplaces β†’ cache-maxxing β†’ Enable auto-update.
  • Any time: run /cmaxx-update. If a newer version is out, it updates the plugin (in the terminal) or tells you how (desktop app, VS Code). Either way it refreshes the model and price list, so a newly released model is priced at once.
  • A chat on a newly launched model ends with new model? try /cmaxx-update.

How the bar decides

From top to bottom, the first rule that fits:

  1. No reply yet in this chat: βšͺ️ "cache-maxxing will start after you send a message".
  2. Cache expired or reset, and the rebuild costs more than the rebuild limit: πŸ”΄, suggesting /cmaxx-handoff with what it would save.
  3. Cache expired or reset, rebuild below the limit: 🟠 small chat, fine to keep going.
  4. Under 15 minutes left on the 1-hour cache: 🟑 reply soon.
  5. Active, but the chat is past the long-chat size: 🟒 with a handoff suggestion for when you're done.
  6. Otherwise: 🟒 keep going.
🟒 48 min left Β· next message β‰ˆ $0.01 Β· 50K / 1M Β· βœ… Keep going
🟑 12:30 min left Β· next message β‰ˆ $0.05, later β‰ˆ $1.82 (40Γ— more) Β· 228K / 1M Β· ⏳ Reply soon or try /cmaxx-handoff
πŸ”΄ cache expired Β· next message β‰ˆ $2.32 (40Γ— more) Β· 290K / 1M Β· πŸ”„ Try /cmaxx-handoff to save 232K tokens | $2.21

Costs are estimates at standard API list prices, and a floor: a reply that uses tools sends several requests. On a subscription you don't pay these dollars; read them as how much of your usage a message takes. "Active" means very likely active: in our measurements about 2 in 100 messages missed the cache even within the time limit.

Privacy

  • The bar sends nothing anywhere and never calls a model. Everything it shows is worked out on your computer.
  • Two commands reach outside, only when you run them:
    • /cmaxx-handoff sends Claude Haiku an abbreviated copy of the chat (the last 120 messages, long ones cut, tool output left out). The briefing is saved in your project under .claude/handoffs/, which gets its own .gitignore, so briefings are never committed.
    • /cmaxx-update downloads this plugin's version number and price list from this repository and sends nothing. GitHub sees your IP address, as for any download.
  • Stored on your computer: a small record per chat (time of the last reply, chat size, model) for 7 days, and counts for /cmaxx-stats (numbers only, each chat's for 90 days, the totals for good). Never the chat's text!

Limitations

  • If your organization blocks Haiku, /cmaxx-handoff writes a facts-only briefing that keeps your last message, and says why.
  • The handoff's saving is an estimate: Haiku's share and a fresh chat's start are taken from measured medians, priced as Claude Haiku 5.5.
  • Switching model and back within the hour shows "cache reset", although the first model's cache may still be warm.
  • /cmaxx-stats reads an older chat's history from its transcript only up to 4 MiB; a bigger chat that started before you installed the plugin is counted from when the plugin first saw it.
  • A brand-new chat in the desktop app shows the bar only after your first message: the app starts the chat, and its plugins, at that point.

FAQ

Does it cost anything to run? The bar, no. /cmaxx-handoff makes one small Haiku call, typically about a cent at API prices.

I'm on a subscription. Are the dollar amounts real? They're API list prices, a way to compare. Set Show cost as to times to see "40Γ— more" instead.

Contributing

Issues and pull requests are welcome. See CONTRIBUTING.md for setup, tests and the project rules, and SECURITY.md to report a vulnerability privately. Changes are listed in CHANGELOG.md.

License

MIT Β© 5m0k3

Related Skills

View on GitHub
GitHub Stars45
CategoryDevelopment
Updated21h ago
Forks2

Languages

TypeScript

Trust signals

97/100

From repository metadata: license, adoption, age and documentation. Not a code audit β€” see the Safety scan above for what the skill file itself contains.

1 info
cache-maxxing β€” Claude Code Skill: Install & Safety Check | SkillAgent