Claude Code mod

cache-timer

Prompt cache countdown and auto-compact for Claude Code: a progress bar in the status line and above the prompt, a /cache pane with settings, expiry reminders, and compaction before the cache expires so you don't pay to re-cache a long context

Context & usage modsValidates on Claude Code 2.1.319 Source

Install

From source
git clone https://github.com/mileschintw/claude-cache-timer.git
claude --plugin-dir ./claude-cache-timer/.

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 mod state, persists state, draws
Sees
compaction, classic hooks
Draws in
AbovePromptPane
Hooks
session.startturn.stepturn.startturn.completesession.compactclassic.SessionStartui.closeclassic.PostModelSwitchcommand.runui.render

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

Folder
.
Author
mileschintw
License
MIT
Last updated
15 October 2026

FAQ

What is cache-timer?

Prompt cache countdown and auto-compact for Claude Code: a progress bar in the status line and above the prompt, a /cache pane with settings, expiry reminders, and compaction before the cache expires so you don't pay to re-cache a long context It is a mod for Claude Code, from mileschintw/claude-cache-timer on GitHub.

What can the cache-timer mod access?

Its widest reach is "writes or runs" (drives Claude, reads mod state, persists state, draws). It sees compaction, classic hooks. It draws in AbovePrompt, Pane. Like any mod, it runs with your permissions.

How do I install cache-timer?

Clone mileschintw/claude-cache-timer and start Claude Code with --plugin-dir pointing at the mod's folder (.).

More context & usage mods

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