ishuagrawal

Cache Watch — Development skill for Claude Code

Development community

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

README

Every state of the cache-watch band, captured in the Claude desktop app

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