Claude Code mod

cache-timer

A countdown in the prompt footer: under the hint line on the terminal, left of the model picker on the desktop: time left on the prompt cache and how much of the last request it served, or, when the cache was written again while it should have been warm, why (a model switch, an effort change); after a model switch, before anything is sent, what the other model will write. In Ghostty a big cache also raises a macOS notification before it expires and on a rebuild nobody asked for. Olive while there is plenty, warmer at 10, 5 and 2 minutes left (scaled down for a 5-minute cache). The lifetime follows Claude Code's own rules: 1 hour on a subscription, 5 minutes on an API key or usage credits.

1 starsContext & usage modsValidates on Claude Code 2.1.316 Source

Install

From source
git clone https://github.com/Sanexxxx777/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: runs processes, reads files, reads env vars, draws
Sees
classic hooks
Draws in
PromptHintSessionMode
Hooks
session.startsession.endturn.stepclassic.PostModelSwitchclassic.PostCompactui.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
Aleksandr_NFA
License
MIT
Last updated
7 October 2026

FAQ

What is cache-timer?

A countdown in the prompt footer: under the hint line on the terminal, left of the model picker on the desktop: time left on the prompt cache and how much of the last request it served, or, when the cache was written again while it should have been warm, why (a model switch, an effort change); after a model switch, before anything is sent, what the other model will write. In Ghostty a big cache also raises a macOS notification before it expires and on a rebuild nobody asked for. Olive while there is plenty, warmer at 10, 5 and 2 minutes left (scaled down for a 5-minute cache). The lifetime follows Claude Code's own rules: 1 hour on a subscription, 5 minutes on an API key or usage credits. It is a mod for Claude Code, from Sanexxxx777/claude-cache-timer on GitHub.

What can the cache-timer mod access?

Its widest reach is "writes or runs" (runs processes, reads files, reads env vars, draws). It sees classic hooks. It draws in PromptHint, SessionMode. Like any mod, it runs with your permissions.

How do I install cache-timer?

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

Is cache-timer popular?

Sanexxxx777/claude-cache-timer has 1 GitHub stars and 0 forks, and is included in 1 curated Claude Code list. It was last updated on 7 October 2026.

More context & usage mods

cache-timer

1

MarekBartczak/claude-cache-timer

Live countdown above the prompt until your session's prompt cache expires, with an optional keep-alive that keeps it warm while you're away

Context & usage mods/plugin install

capsule-panel

1

jsh135790/claude-code-capsule-panel

Live usage dashboard: context, cache, rate limits, cost and activity in a capsule-style pane.

Context & usage mods/plugin install

cache-timer

1

EricJamie/claude-code-mods

A countdown to when the conversation's prompt cache expires, in the prompt footer before the model name

Context & usage mods/plugin install

cc-contextbar

1

evggzzz/cc-contextbar

Battery-style context bar for Claude Code, drawn as a live band above the prompt: real context %, session cost, and quota windows that follow the surface — z.ai quota in the terminal, Claude-plan rate limits in the desktop Code tab. Also still ships the classic statusline script.

Context & usage mods/plugin install

cache-tax

1

Orfila-antoine/claude-mods

Keeps the one-hour prompt cache warm during breaks and stops a cold send once with its estimated rewrite cost; its status line sits in the modkit band. Adapted from cache-tax by Karan Bansal (MIT).

Context & usage mods/plugin install

cc-jev-pruner

1

masseater/cc-jev-teacher

Keeps Claude Code's context small with a decision model on OpenRouter: compacts without a summary by dropping tool calls the task no longer needs, trims long Bash output to the parts that matter, and finds the code behind a behavior with Jevgrep

Context & usage mods/plugin install

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