Claude Code mod
idle-compact
Runs /compact while the session sits idle waiting on background work, right before the prompt cache expires.
Install
/plugin marketplace add ShadowDog007/claude-mods
/plugin install idle-compact@shadow-claude-modsMods 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, reads mod state, draws
- Sees
- every tool call, every prompt
- Hooks
session.startcommand.runsession.endsession.measureturn.startturn.stepturn.completetool.callprompt.submit
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
- ShadowDog007/claude-mods
- Folder
plugins/idle-compact- Marketplace
shadow-claude-mods- Author
- Michael McKnight
- Last updated
- 26 October 2026
- Listed in
- awesome-claude-code-mods
FAQ
What is idle-compact?
Runs /compact while the session sits idle waiting on background work, right before the prompt cache expires. It is a mod for Claude Code, from ShadowDog007/claude-mods on GitHub.
What can the idle-compact mod access?
Its widest reach is "writes or runs" (drives Claude, reads env vars, reads settings, reads mod state, draws). It sees every tool call, every prompt. Like any mod, it runs with your permissions.
How do I install idle-compact?
Inside Claude Code (v2.1.287 or later), run /plugin marketplace add ShadowDog007/claude-mods and then /plugin install idle-compact@shadow-claude-mods.
More context & usage mods
idle-compact
m-mizutani/dotfiles
Compact the conversation once after 50 idle minutes, while the 1h prompt cache is still warm.
idle-compact
wryskware/claude-mods
Compacts the session once it is 20% full and has been idle 50 minutes, while the prompt cache is still warm.
huginn
tauantcamargo/claude-mods
Huginn, Odin's raven of thought: matches model and effort to each step. Skills that set the effort for the rest of the turn without breaking the prompt cache (/huginn:deep, /huginn:quick, /huginn:max), Sonnet, Opus and Fable subagents for delegated work, a session-start policy that tells Claude when to use which, and a status-line chip with the active tier.
idle-compact
xyjk0511/idle-compact
Compact once after 50 idle minutes, while the 1h prompt cache is still warm. Works in the desktop app and SDK sessions too.
hudcade
g761007/hudcade
A pixel-art HUD for Claude Code: context, cost, cache, agents and rate limits at a glance, little 8-bit scenes while Claude thinks, and Telegram notifications.
inline-replies
betoescobar46/pituto
Answer Claude's questions and quote its paragraphs with a click: numbered questions with clickable options, a on every paragraph, and the full context sent along with your message.
Browse the most popular Claude Code mods, all context & usage mods, or the skills and MCP server directories.