Claude Code mod

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.

4 starsContext & usage modsValidates on Claude Code 2.1.316 Source

Install

From source
git clone https://github.com/ukwhatn/.claude.git
claude --plugin-dir ./.claude/skills/idle-compact

The repo has no marketplace file, so load the plugin folder directly with --plugin-dir.

What it can access

Reach
L2Writes or runs: drives Claude, reads files, reads env vars, reads mod state, draws
Sees
compaction
Hooks
session.startturn.startturn.completesession.compact

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
ukwhatn/.claude
Folder
skills/idle-compact
Author
ukwhatn
Type
Context & usage mods
Last updated
1 November 2026
Listed in
awesome-claude-code-mods

FAQ

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

What can the idle-compact mod access?

Its widest reach is "writes or runs" (drives Claude, reads files, reads env vars, reads mod state, draws). It sees compaction. Like any mod, it runs with your permissions.

How do I install idle-compact?

Clone ukwhatn/.claude and start Claude Code with --plugin-dir pointing at the mod's folder (skills/idle-compact).

Is idle-compact popular?

ukwhatn/.claude has 4 GitHub stars and 0 forks, and is included in 1 curated Claude Code list. It was last updated on 1 November 2026.

More context & usage mods

crab-cam

4

sTomerG/agent-kit

A crab above the prompt acts out what Claude is doing: reading, writing code, thinking, searching and more. A shell beside it shows context and rate-limit usage, and the Crab crew pane gives every subagent a crab of its own.

Context & usage mods/plugin install

miod

4

delexw/miod

Generative music for Claude Code. Every task gets its own tune, and the mood follows what the agent is doing and how fast it spends tokens.

Context & usage mods/plugin install

cost-ledger

4

FynnXland/fynn-mods

Cost ledger across all chats: after every answer it records the chat cost (as /cost), tokens per model and model calls made by other mods. /ledger shows today, 7 and 30 days, total, history by model (days or weeks), projects and the most expensive chats; /ledger limits shows the API value in the current 5-hour and weekly window and in your subscription month, plus an estimate of the usage outside the ledger (claude.ai, phone); /ledger sync <folder> merges your devices through a shared folder (amounts only: no paths, projects or chat titles); /ledger help lists all commands, the current state and your settings. Observer only, no model calls.

Context & usage mods/plugin install

night-feast

4

theonly1me/claude-code-mods

A vampire feeds on every tool call Claude finishes while the moon tracks how full the context window is. Between meals it stalks, swoops, and lies in wait. Dawn means it is time to compact.

Context & usage mods/plugin install

clawd-hud-spike

4

soulrocha/Claude-code-hero-journey

Spike da HUD RPG: sondas no app real para os itens A VALIDAR (sem gastar tokens)

Context & usage mods

noctis

4

synex1437/noctis

Runs long Claude Code jobs overnight within your usage limits: pauses just before the 5-hour or weekly limit, resumes the same session after the reset (or relaunches it days later) and works through a list of jobs you hand it with /noctis:start <file>. Also runs in Codex CLI, Antigravity CLI, Droid and Copilot CLI.

Context & usage mods/plugin install

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