Claude Code mod

idle-compact

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

17 starsContext & usage modsValidates on Claude Code 2.1.316 Source

Install

From source
git clone https://github.com/takahirom/takahirom-claude-code-marketplace.git
claude --plugin-dir ./takahirom-claude-code-marketplace/plugins/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, draws
Sees
compaction
Hooks
turn.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
takahirom/takahirom-claude-code-marketplace
Folder
plugins/idle-compact
Type
Context & usage mods
License
Apache-2.0
Last updated
26 September 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. It is a mod for Claude Code, from takahirom/takahirom-claude-code-marketplace on GitHub.

What can the idle-compact mod access?

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

How do I install idle-compact?

Clone takahirom/takahirom-claude-code-marketplace and start Claude Code with --plugin-dir pointing at the mod's folder (plugins/idle-compact).

Is idle-compact popular?

takahirom/takahirom-claude-code-marketplace has 17 GitHub stars and 0 forks, and is included in 1 curated Claude Code list. It was last updated on 26 September 2026.

More context & usage mods

account-rotator

17

ivokund/claude-account-rotator

Moves Claude Code between your Claude accounts as their usage limits fill, shows each account's usage under the prompt, and signs an account back in with one click.

Context & usage mods/plugin install

pixelband

17

furqan-khan07/pixelband

Animated pixel art above your Claude Code prompt that reacts while Claude works: eight scenes, or your own image or GIF. Zero tokens.

Context & usage mods/plugin install

usage-band

18

JetsonChan/CC-Usage-Band

A band above the prompt showing your 5-hour and 7-day limits, context window and prompt-cache hit rate, styled for the terminal and the desktop app

Context & usage mods/plugin install

usage-meter

16

rohit3a/usage-meter

See where every Claude token goes, live: plan-limit % used and left, burn rate, tokens and API-equivalent $, by session, subagent, model and machine

Context & usage mods/plugin install

statuspane

18

xuanji86/claude-statuspane

A floating status card above the Claude Code prompt — model, effort, context, 5h/week limits, cost, directory and branch, GitHub CI and deploys — with clickable settings and a progress-row API any script or mod can feed.

Context & usage mods/plugin install

token-usage

15

letswritetw/claude-mod-token-usage

5h / 7d usage, token totals and cost pills above the prompt

Context & usage mods

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