claudemods

All Claude Code modsymnao/dotfiles

idle-compactor

A Claude Code mod in ymnao/dotfiles

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.

idle-compactor reaches L2 (writes or runs) and passed claude plugin validate with warnings on Claude Code 2.1.302.

To install it, open the repository and follow the author’s setup instructions. Mods need Claude Code 2.1.287 or later.

Access

L2 Writes or runsdrives Claude, reads env vars, reads settings, persists state, draws

Validation

Passed with warnings on Claude Code 2.1.302

View the source on GitHub Back to the list

What the scan recorded

Observed events
compaction
Hooks
session.start, command.run {command=idle-compactor}, turn.start, turn.complete, session.compact
API calls
$.clock.every, $.clock.now, $.command.register, $.command.run, $.env.get, $.session.compact, $.session.id, $.session.usage, $.settings.read, $.store.get, $.store.set, $.ui.log
Validation on 2.1.302
Passed with warnings
Scanned revision
a0d407d0317b
Marketplace warnings
claude-idle-compactor

These are the hooks and API calls reported by claude plugin validate. Access levels describe the widest reach of those calls and are not safety ratings. Validation is a static check, not a runtime test, and a passing result does not prove that a mod works or is safe. How the scan works.

More from ymnao/dotfiles

Badge for your README

Reach badge for idle-compactor Validation badge for idle-compactor

Authors can show the latest scan result in their README. Each badge links to this page.

[![reach](https://raw.githubusercontent.com/karanb192/awesome-claude-code-mods/main/badges/ymnao--dotfiles--idle-compactor-reach.svg)](https://mods.aidojo.si/mods/ymnao--dotfiles--idle-compactor/)
[![validates](https://raw.githubusercontent.com/karanb192/awesome-claude-code-mods/main/badges/ymnao--dotfiles--idle-compactor-validates.svg)](https://mods.aidojo.si/mods/ymnao--dotfiles--idle-compactor/)