Claude Code mod
cache-timer
Shows how long the prompt cache stays warm, as a dim Cache mm:ss countdown in the footer of Claude Code Desktop, restarted by each model response of the main thread. The cache lifetime (5 minutes or 1 hour, per account) is learned from the responses: a cache read after more than five idle minutes means one hour, a full rewrite means five; until then the countdown shows ~ and assumes five
Install
/plugin marketplace add bqnhat/claude-local-plugins
/plugin install cache-timer@nhat-localMods install like plugins. Run /reload-plugins or start a new session to load it.
What it can access
- Reach
- L1Reads: reads mod state, persists state, draws
- Draws in
SessionMode- Hooks
session.startturn.stepui.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.
Details
- Repository
- bqnhat/claude-local-plugins
- Folder
plugins/cache-timer- Marketplace
nhat-local- Author
- bqnhat
- License
- MIT
- Last updated
- 9 October 2026
- Listed in
- awesome-claude-code-mods
FAQ
What is cache-timer?
Shows how long the prompt cache stays warm, as a dim Cache mm:ss countdown in the footer of Claude Code Desktop, restarted by each model response of the main thread. The cache lifetime (5 minutes or 1 hour, per account) is learned from the responses: a cache read after more than five idle minutes means one hour, a full rewrite means five; until then the countdown shows ~ and assumes five It is a mod for Claude Code, from bqnhat/claude-local-plugins on GitHub.
What can the cache-timer mod access?
Its widest reach is "reads" (reads mod state, persists state, draws). It draws in SessionMode. Like any mod, it runs with your permissions.
How do I install cache-timer?
Inside Claude Code (v2.1.287 or later), run /plugin marketplace add bqnhat/claude-local-plugins and then /plugin install cache-timer@nhat-local.
More context & usage mods
cache-tax
Isaacg1000/isaac-mods
Warns before a prompt that would reload a cold prompt cache, with a token and cost estimate; /keepwarm keeps it warm.
cache-timer
katipally/modz
Prompt cache hit rate for the last request, and whether the cache is still warm with a countdown, above the prompt
cache-tax
gauravruhela07/claude-mods
How well the prompt cache works and what the cache tax costs: hit %, cost and the money paid above all-cache-read, per turn, with cache-bust alerts.
cache-waechter
Savo2610/claude-mods
Warnt vor teuren Nachrichten in großen, kalt gewordenen Sitzungen, zeigt die Cache-Restzeit unten rechts nur bei Bedarf und fragt vor dem Abkühlen per Telegram nach.
cache-meter
gauravlahoti/claude-mods
A band above the prompt showing how long the prompt cache stays warm, the last turn's hit rate, and a Compact button
cm-context-meter
rotbit/claudemods-marketplace
Puts context-window fill, 5-hour/7-day plan usage and session cost in the status line, and warns once when the context gets full.
Browse the most popular Claude Code mods, all context & usage mods, or the skills and MCP server directories.