cache-timer

by Aleksandr_NFA · ★ 1 · updated 2 days ago

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. 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.

install cache-timer

Install

git clone https://github.com/Sanexxxx777/claude-cache-timer

claude --plugin-dir ./claude-cache-timer

Then run /reload-plugins or start a new session. Requires Claude Code 2.1.287+.

View source on GitHub

What it hooks into

From an automated scan with claude plugin validate, not a security review. Mods run with your permissions; read the code before installing.

Events: session.startsession.endturn.stepui.render
API calls: $.clock.every$.env.get$.fs.read$.session.cwd$.session.usage$.ui.invalidate$.ui.log$.ui.resolve$.ui.toast
Draws: PromptHintSessionMode
Reach: level 1 of 3 reads filesreads env varsdraws

Origin

How it got here: Automated scan of public GitHub repos, via the CC0 dataset awesome-claude-code-mods (scan of 6 Oct 2026).
Repository: github.com/Sanexxxx777/claude-cache-timer
Path in repo: repository root
Source commit: f0d2f31 the exact code the scan read
Author: Aleksandr_NFA @Sanexxxx777
License: MIT
First published: 4 Oct 2026
Last pushed: 4 Oct 2026
First listed here: 7 Oct 2026

Name and description come from the mod's own manifest. We link to the code; we don't host it, and it stays under its author's license.