Claude Code mod

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.

Context & usage mods Plugin marketplaceValidates on Claude Code 2.1.316 Source

Install

Inside Claude Code
/plugin marketplace add xyjk0511/idle-compact
/plugin install idle-compact@idle-compact

Mods install like plugins. Run /reload-plugins or start a new session to load it.

What it can access

Reach
L2Writes or runs: runs processes, drives Claude, draws
Sees
compaction
Draws in
SessionMode
Hooks
ui.renderturn.startturn.completesession.compactsession.end

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.
Claude Code docs

Details

Repository
xyjk0511/idle-compact
Folder
plugins/idle-compact
Marketplace
idle-compact
Author
xyjk0511
Type
Context & usage mods
License
Apache-2.0
Last updated
4 October 2026
Listed in
awesome-claude-code-mods

FAQ

What is 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. It is a mod for Claude Code, from xyjk0511/idle-compact on GitHub.

What can the idle-compact mod access?

Its widest reach is "writes or runs" (runs processes, drives Claude, draws). It sees compaction. It draws in SessionMode. 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 xyjk0511/idle-compact and then /plugin install idle-compact@idle-compact.

More context & usage mods

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.

Context & usage mods/plugin install

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.

Context & usage mods/plugin install

idle-compact

ShadowDog007/claude-mods

Runs /compact while the session sits idle waiting on background work, right before the prompt cache expires.

Context & usage mods/plugin install

integral

serg-yalosovetsky/integral

One HUD above the prompt: context bar with compact/checkpoint, plan limits, MCP health, plan progress. Replaces context-bar-compact and mcp-doctor.

Context & usage mods/plugin install

idle-compact

m-mizutani/dotfiles

Compact the conversation once after 50 idle minutes, while the 1h prompt cache is still warm.

Context & usage mods

jc-hud-mod

karimdjaafar/jc-hud-mod

JC HUD — mod Claude Code : barre d'instruments Jasmine Conseil (contexte, forfait, modèle, horloges)

Context & usage mods

Browse the most popular Claude Code mods, all context & usage mods, or the skills and MCP server directories.