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-maxxingInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Development & EngineeringSupported Platforms
Tags
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.
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.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| cache-maxxing (this skill)by 5m0k3 | 84 | 45 | today | SKILL.md |
| taste-skillby Leonxlnx | 100 | 118.9k | 11d ago | CLAUDE.md |
| hyperframesby heygen-com | 100 | 87.1k | today | CLAUDE.md |
| rufloby ruvnet | 100 | 82.1k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 80.2k | today | CLAUDE.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.
Skill content
View source on GitHubcache-maxxing
See when Claude's prompt cache expires, and what your next message will cost, before you send it.
</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
- Click + next to the chat box, then Plugins β Manage Plugins.
- On top right press + Add β Add marketplace β Add from a repository and enter
5m0k3/cache-maxxing. - 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:
- No reply yet in this chat: βͺοΈ "cache-maxxing will start after you send a message".
- Cache expired or reset, and the rebuild costs more than the rebuild limit: π΄, suggesting
/cmaxx-handoffwith what it would save. - Cache expired or reset, rebuild below the limit: π small chat, fine to keep going.
- Under 15 minutes left on the 1-hour cache: π‘ reply soon.
- Active, but the chat is past the long-chat size: π’ with a handoff suggestion for when you're done.
- 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-handoffsends 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-updatedownloads 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-handoffwrites 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-statsreads 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
taste-skill
118.9kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
hyperframes
87.1kAI video you can actually edit. HyperFrames is a free, open-source AI video editor. Describe any video and get a real project you can change down to the frame.
ruflo
82.1kπ The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
80.2kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit β see the Safety scan above for what the skill file itself contains.
