What is warm-compact?
warm-compact is a Claude Code mod by ziedgithub that compacts an idle session just before its prompt cache goes cold, or keeps the cache warm while you're away, so your next prompt doesn't re-read the whole conversation uncached. Two chips. It is listed under Cost & usage and has no public popularity data yet.
| Type | Claude code mod |
|---|---|
| Author | ziedgithub |
| Repository | ziedgithub/claude-code-mods |
| Popularity | no public popularity data yet |
| Category | Cost & usage |
| Security | Review before installing (72/100) |
| Rank | #5,251 of 5,272 Claude Code mods; #1,031 in Cost & usage |
| License | MIT |
| Last commit | 2026-10-17 |
| Hooks | 9 events |
| Sees | compaction |
| Draws on | PromptHint |
Is warm-compact safe to install?
warm-compact scores 72/100 on the MCPMods security check: Review before installing. Things to review: writes files or config; reads environment variables. It passed 5 of 8 checks.
Mod footprints come from claude plugin validate, which lists every event a mod hooks and every API call it makes without running it.
| Check | Result |
|---|---|
| No network access | Pass |
| Starts no processes | Pass |
| Writes files or config | Review |
| Reads environment variables | Review |
| Only sees the events it hooks | Pass |
| Drives Claude (model calls, prompts) | Note |
| Passes claude plugin validate | Pass |
| Has an open-source license | Pass |
API calls in its code
| Call | What it means |
|---|---|
$.clock.every | |
$.clock.now | |
$.command.register | |
$.env.get | reads env vars |
$.fs.read | reads files |
$.fs.write | writes files |
$.model.fork | drives Claude |
$.prompt.read | |
$.session.compact | drives Claude |
$.session.id | |
$.session.model | |
$.session.usage | |
$.session.version | |
$.settings.read | reads settings |
$.state.get | |
$.state.set | |
$.store.get | keeps its own state |
$.store.set | keeps its own state |
$.ui.log | draws interface |
$.ui.resolve | draws interface |
$.ui.status | draws interface |
$.ui.toast | draws interface |
How do I install warm-compact?
- Check your Claude Code version. Mods need Claude Code 2.1.287 or later and are on by default.
claude --version
- Read its footprint. This lists every event it hooks and every API call it makes, without running it.
git clone https://github.com/ziedgithub/claude-code-mods claude plugin validate ./claude-code-mods/warm-compact
- Install it. Run this in your terminal, then /reload-plugins in an open session.
claude plugin marketplace add ziedgithub/claude-code-mods && claude plugin install warm-compact@zied-mods
Or ask Claude to set it up
Paste this into Claude Code and it installs warm-compact for you:
Install the "warm-compact" Claude Code mod from https://github.com/ziedgithub/claude-code-mods/tree/main/warm-compact. Run claude plugin validate on it first and show me what it can access before you enable it.
More from ziedgithub/claude-code-mods
This repository has 3 Claude Code mods on MCPMods.
- context-bar: A footer showing the model and effort, how full the context window is, and the prompt cache, with one-click compact and (Low risk)
- crab-buddy: A pixel-art Claude crab above the prompt that works, thinks, cheers and sleeps with the session, with a small crab for e (Low risk)