Claude Code mod
idle-compactor
Compacts an idle Claude Code session shortly before its 1-hour prompt cache expires, so coming back later re-sends a short summary instead of the whole conversation uncached.
Install
/plugin marketplace add ymnao/dotfiles
/plugin install idle-compactor@claude-idle-compactorMods install like plugins. Run /reload-plugins or start a new session to load it.
What it can access
- Reach
- L2Writes or runs: drives Claude, reads env vars, reads settings, persists state, draws
- Sees
- compaction
- Hooks
session.startcommand.runturn.startturn.completesession.compact
From a static scan of the mod's code by awesome-claude-code-mods. It shows what the code asks for, not a security review.
How Claude Code mods work
- A mod is a plugin with a JavaScript or TypeScript module that runs inside Claude Code (version 2.1.287 or later). It can draw panes beside the transcript, a band above the prompt, buttons and toasts, restyle the spinner and tool rows, and watch or rewrite tool calls and prompts.
- It installs like any plugin: add its marketplace with /plugin marketplace add owner/repo, then /plugin install name@marketplace.
- Check what a mod can reach before installing: it runs with your permissions. Reach goes from drawing only, to reading files, to writing files or running processes, to the network. Run claude plugin validate on a clone to list its hooks and calls without running it.
- Turn one off from the Installed tab in /plugin, or start Claude Code with --safe-mode to skip every customization for a session.
Details
- Repository
- ymnao/dotfiles
- Folder
claude/plugins/idle-compactor/plugin- Marketplace
claude-idle-compactor- Author
- intenex
- Last updated
- 31 October 2026
- Listed in
- awesome-claude-code-mods
FAQ
What is idle-compactor?
Compacts an idle Claude Code session shortly before its 1-hour prompt cache expires, so coming back later re-sends a short summary instead of the whole conversation uncached. It is a mod for Claude Code, from ymnao/dotfiles on GitHub.
What can the idle-compactor mod access?
Its widest reach is "writes or runs" (drives Claude, reads env vars, reads settings, persists state, draws). It sees compaction. Like any mod, it runs with your permissions.
How do I install idle-compactor?
Inside Claude Code (v2.1.287 or later), run /plugin marketplace add ymnao/dotfiles and then /plugin install idle-compactor@claude-idle-compactor.
Is idle-compactor popular?
ymnao/dotfiles has 1 GitHub stars and 0 forks, and is included in 1 curated Claude Code list. It was last updated on 31 October 2026.
More context & usage mods
idle-compact
1benredmond/idle-compact
Compacts an idle session just before its prompt cache expires, so returning does not re-write the full context
idlecrash
1grozoww/idlecrash
Crash with fake tokens against other people who are also waiting for Claude: in a pane, in a terminal and in the desktop app.
hud
1Samarth2001/claude-plugins
A live usage cockpit above the prompt: context, plan limits with pace forecasts, and cost by day, week and month, in a one-line glance that expands into tabs and a dashboard pane
image-peek
1youngOman/pill-mods
image-view (jarrodwatts) fixed for newer Claude Code: thumbnails of pasted images above the prompt, read from $TMPDIR/clipboard-*.png.
hud
1BedirYilmaz/claude-crt-hud-mod
A CRT-style status panel above or below the prompt: model, project and git, context with a compact button, plan usage, prompt cache, cost and running tools. /hud toggles it.
jev-context
1JayDoubleu/cc-mod-jev
Jev-scored context pruning for Claude Code through OpenRouter: at compaction every tool call and result is scored by TypeSafe's Jev decision model, stale ones are dropped or truncated, everything kept stays verbatim. An optional gate truncates oversized tool outputs as they arrive.
Browse the most popular Claude Code mods, all context & usage mods, or the skills and MCP server directories.