idle-compact
Compacts once after fifty idle minutes, before cache expiry.
Source and capability notes checked · By takahirom · Updated Oct 16, 2026
What idle-compact looks like in use
No recording yet for idle-compact. The repository README has the details.
Before you install
A mod is not sandboxed. It runs inside Claude Code with your permissions. This one:
- can read Turn completion and session timing
- can spend Your usage allowance
Check it yourself before running it: git clone https://github.com/takahirom/takahirom-claude-code-marketplace && claude plugin validate ./ · Apache-2.0 licensed
Install
claude plugin marketplace add takahirom/takahirom-claude-code-marketplace
claude plugin install idle-compact@takahirom-claude-code-marketplace
Needs Claude Code 2.1.287 or later. After installing, run
/reload-plugins if the session was already open.
Full install guide
What changes after installation
After a normal answer, the mod schedules one compaction at approximately fifty minutes of inactivity. A transcript line tells you when it will happen, and a later line reports cache readback from the compaction.
Sending a message, ending the session or compacting through another route cancels the timer.
Good to know
The schedule assumes a one-hour prompt cache and is unsuitable as a five-minute-cache strategy. A sleeping machine can push the timer outside its accepted window, in which case it skips. Use it only if you are comfortable with automatic loss of detailed context in exchange for a smaller returning session.
Similar mods
context-inspector
Finds repeated reads, similar outputs and compaction-related waste.
cache-tax
Keeps the prompt cache warm during breaks and stops a cold send once — with its price.
cache-keeper
Combines cache timing, cold-send warnings, chat board and handoff.
agent-usage-guard
Holds a burst of subagents, a huge prompt or a retry loop before it eats your plan window.
Popular mods
agent-profiler
Breaks a session into model wait, tool and subagent time.
Agent Time Machine
Records tool calls and project snapshots on a branching timeline.
loop-detective
Collects evidence when the same Bash failure keeps repeating.
pin-memo
Keeps personal notes and todos above the prompt across resumes.