cache-timer

by mileschintw · ★ 0 · updated 15 Oct 2026

PanesBandsStatus lineCommandswarnings

0

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

install cache-timer

Install

git clone https://github.com/mileschintw/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.startturn.stepturn.startturn.completesession.compactclassic.SessionStartui.closeclassic.PostModelSwitchcommand.runui.render
API calls
$.clock.every$.clock.now$.command.register$.command.run$.session.compact$.session.id$.state.get$.state.set$.store.delete$.store.get$.store.keys$.store.set$.ui.close$.ui.log$.ui.notify$.ui.open$.ui.panes$.ui.resolve$.ui.status$.ui.toast
Draws
AbovePromptPane
Can see
compactionclassic hooks
Reach
level 2 of 3 drives Claudereads mod statepersists statedraws

Origin

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

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.