idle-compact

Compacts the main conversation once it has sat idle for idleMinutes, while the prompt cache is still warm, and hands every compaction of the main conversation (manual, auto, plugin, precompute) the Compact Instructions section of the user's AGENTS.md. Skips while a turn runs, below minMessageTokens of conversation, and past cutoffMinutes (a wake from sleep, when the cache has likely expired), saying which in the transcript; a reload of the plugin keeps the pending idle stretch.

idle-compact reaches L2 (writes or runs) by its classified calls and passed claude plugin validate on Claude Code 2.1.302.

Events hooked: 4
API methods referenced: 9
Access from classified calls: L2, writes or runs: drives Claude, reads files, reads env vars, draws
Unclassified calls: 2 ($.state.get, $.state.set), full access unknown
Static scan, not a runtime test

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 runsother: $.state.get, other: $.state.set, drives Claude, reads files, reads env vars, draws

Validation

Passed 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, turn.start, turn.complete, session.compact
API calls: $.clock.after, $.clock.now, $.env.get, $.fs.read, $.session.compact, $.session.usage, $.state.get, $.state.set, $.ui.log
Validation on 2.1.302: Passed
Scanned revision: 92c6119e010a

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.

Badge for your README

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/ukwhatn--.claude--idle-compact-reach.svg)](https://mods.aidojo.si/mods/ukwhatn--.claude--idle-compact/)
[![validates](https://raw.githubusercontent.com/karanb192/awesome-claude-code-mods/main/badges/ukwhatn--.claude--idle-compact-validates.svg)](https://mods.aidojo.si/mods/ukwhatn--.claude--idle-compact/)