idle-compactor

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.

Claude Code

By intenexLicense: MIT0 GitHub starsUpdated 11 hours ago

Directory evidence

Runtimes: Claude Code
Parsed components: 0 skill or MCP entries
Source updated: Sep 23, 2026
Manifest status: Canonical path parsed

The directory validates manifest shape and source location. It does not execute the plugin or provide a security endorsement. Review the indexing methodology →

Install idle-compactor for Claude Code

Installs for the current user

claude plugin marketplace add IchenDEV/agent-plugin-mkt
claude plugin marketplace update agent-plugin-marketplace
claude plugin install idle-compactor@agent-plugin-marketplace

Paste and run these commands in a terminal with Claude Code. They add and refresh the PluginsMP catalog, then install this plugin.

The installer fetches third-party code from the source repository shown on this page. This directory validates manifest structure and source location, but does not perform a security audit; review the manifest, components, and source before installing.

Get the source manually

$ git clone https://github.com/intenex/claude-idle-compactor

Clone the source repository, then follow its setup instructions to add the plugin to a compatible client. The plugin root is plugin/.

Plugin files

plugin/

└── .claude-plugin/plugin.json

Plugin manifests1

plugin/.claude-plugin/plugin.json

{
  "name": "idle-compactor",
  "description": "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.",
  "author": {
    "name": "intenex",
    "url": "https://github.com/intenex"
  },
  "homepage": "https://github.com/intenex/claude-idle-compactor",
  "repository": "https://github.com/intenex/claude-idle-compactor",
  "license": "MIT",
  "keywords": [
    "compact",
    "prompt-cache",
    "idle",
    "tokens"
  ],
  "userConfig": {
    "enabled": {
      "type": "boolean",
      "title": "Idle compaction enabled",
      "description": "Compact idle sessions automatically. Turn off to pause without uninstalling.",
      "default": true
    },
    "idle_minutes": {
      "type": "number",
      "title": "Compact after (minutes idle)",
      "description": "Minutes after the last response before compacting. Must be under the 60-minute cache lifetime.",
      "default": 50,
      "min": 0.5,
      "max": 58
    },
    "cutoff_minutes": {
      "type": "number",
      "title": "Give up after (minutes idle)",
      "description": "If the check first runs later than this (for example after the Mac slept), skip: the cache is likely gone and compacting would be paid at full price.",
      "default": 56,
      "min": 1,
      "max": 59
    },
    "min_context_tokens": {
      "type": "number",
      "title": "Minimum context (tokens)",
      "description": "Only compact sessions whose context is at least this large. Smaller ones gain little from a summary.",
      "default": 30000,
      "min": 0,
      "max": 2000000
    },
    "max_per_day": {
      "type": "number",
      "title": "Max idle compactions per day",
      "description": "Safety cap across all sessions on this machine, per UTC day.",
      "default": 50,
      "min": 0,
      "max": 1000
    }
  }
}

For maintainers

If you maintain this plugin, link to this source-backed listing from your README so users can review its manifest and indexed components.

[idle-compactor on Agent Plugins Marketplace](https://pluginsmp.com/plugins/idle-compactor)