What is idle-compact?
idle-compact is a Claude Code mod by ukwhatn that compacts the main conversation once it has sat idle for idleMinutes, while the prompt cache is still warm, and hands every compaction of the main conversation (manual, auto, plugin,. It is listed under Cost & usage and has 4 GitHub stars.
| Type | Claude code mod |
|---|---|
| Author | ukwhatn |
| Repository | ukwhatn/.claude |
| Popularity | 4 GitHub stars |
| Category | Cost & usage |
| Security | Low risk (84/100) |
| Rank | #771 of 5,272 Claude Code mods; #146 in Cost & usage |
| Last commit | 2026-10-17 |
| Hooks | 4 events |
| Sees | compaction |
| Draws on | nothing |
Is idle-compact safe to install?
idle-compact scores 84/100 on the MCPMods security check: Low risk. Things to review: reads environment variables. It passed 6 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 no files or config | Pass |
| Reads environment variables | Review |
| Only sees the events it hooks | Pass |
| Doesn't drive Claude | Pass |
| Passes claude plugin validate | Pass |
| No license detected | Note |
API calls in its code
| Call | What it means |
|---|---|
$.clock.after | |
$.clock.now | |
$.env.get | reads env vars |
$.fs.read | reads files |
$.session.compact | drives Claude |
$.session.usage | |
$.state.get | |
$.state.set | |
$.ui.log | draws interface |
How do I install idle-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/ukwhatn/.claude claude plugin validate ./.claude/skills/idle-compact
- Install it. Run this in your terminal, then /reload-plugins in an open session.
git clone https://github.com/ukwhatn/.claude && claude --plugin-dir ./.claude/skills/idle-compact
Or ask Claude to set it up
Paste this into Claude Code and it installs idle-compact for you:
Install the "idle-compact" Claude Code mod from https://github.com/ukwhatn/.claude/tree/main/skills/idle-compact. Run claude plugin validate on it first and show me what it can access before you enable it.