Cache Watch — Development skill for Claude Code
Know when your Claude Code prompt cache expires, and what your next message will cost.
How to install Cache Watch
This entry records only its repository, not the path inside it, so there is no
exact command to give. Open ishuagrawal/cache-watch and copy the folder into
~/.claude/skills/, or the file into ~/.claude/agents/.
What Cache Watch does
Know when your Claude Code prompt cache expires, and what your next message will cost.
Alternatives in Development
- Claude Code Everything You Need To Know — Ultimate all-in-one guide to mastering Claude Code 1.3k ★
- Compact 서비스 (대화 요약) — 관찰 위치: Claude Code 내부 아키텍처 변수: NO_TOOLS_PREAMBLE, BASE_COMPACT_PROMPT, PARTIAL_COMPACT_PROMPT, PARTIAL_COMPACT 149 ★
- Ctx Handoff Mod — Claude Code mod: auto handoff to a fresh conversation when context hits a threshold, keeps the prompt cache wa 25 ★
README
cache-watch
**Know when your Claude Code prompt cache expires, and what that costs your next message.**
Claude Code caches your conversation so each message pays full price only for what's new. The cache expires 5 minutes or 1 hour after its last use, depending on your account. After that, your next message rewrites the whole conversation, which can cost about 15× more late in a long session. cache-watch adds a one-line band above the prompt that counts down to that moment.
Features
- Live countdown to the cache expiring, in the terminal and the desktop app
- Your account's real TTL, read from the API's own responses rather than guessed
- Next-message cache cost, and what it will be once the cache expires
- Warnings for anything that resets the cache: expiry, switching models,
/compact
Requirements
- Claude Code 2.1.284 or later, in the terminal or the desktop app
- Function hooks, an early-access Claude Code feature. The API may change between releases.
Install
In Claude Code:
/plugin marketplace add ishuagrawal/cache-watch
/plugin install cache-watch
Or from a shell:
claude plugin marketplace add ishuagrawal/cache-watch
claude plugin install cache-watch
Then start a new session (or run `/reload-plugins`). The band appears after Claude's first reply. To check it's working right away, run `/cachewatch demo`.
**Update:** `claude plugin marketplace update cache-watch`, then `claude plugin update cache-watch`. **Uninstall:** `claude plugin uninstall cache-watch`, then `claude plugin marketplace remove cache-watch`.
Usage
The band needs no setup. It changes with the cache:
| State | Shown when |
|---|---|
| 🟢 Warm | The cache is live. Shows the time left and the next message's cache cost |
| 🟡 Expiring | Under 10 min le |
Related Skills
Herdr Auto Warm Cache
A herdr plugin that keeps an idle agent's prompt cache warm before the one-hour TTL expires — 20x cheaper than
Agentic Coding Harness
Run, watch, and meter Claude Code, Codex CLI, Gemini CLI, OpenCode, and Kiro from one CLI. Normalized events,
Flowmeter Public
Local, privacy-first token, cost, cache, and trace analysis for Cursor, Claude Code, and Codex. Optional Flow-
Claude Cache Watch
Local macOS app and CLI for estimating Claude Code prompt-cache expiry
Cache Tax
Keep Claude Code’s prompt cache warm during breaks and show the estimated cost before a cold send.
Wirescope
A transparent analytical proxy for the Claude Code & Codex CLIs — see the real per-turn cost, prompt-cache war
Related Agents
LLM Provider Compat Reviewer
SkillForge LLM provider 兼容性专项 reviewer。对 skillforge-core/llm/ / ClaudeProvider / OpenAiProvider / ProviderProt
Ceo Postmortem
Closes out a work session with the org. Use when the user says they are done for the session, asks for a wrap-
CI Watcher
Watch PR checks for the current branch and report pass/fail with relevant links and concise next steps. Use wh