deadblue22

Claude Cache Watch — Development skill for Claude Code

Development community

Local macOS app and CLI for estimating Claude Code prompt-cache expiry.

How to install Claude Cache Watch

This entry records only its repository, not the path inside it, so there is no exact command to give. Open deadblue22/claude-cache-watch and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Claude Cache Watch does

Local macOS app and CLI for estimating Claude Code prompt-cache expiry.

Alternatives in Development

Epic Publish — Publish a validated epic update back to the issue and local cache 243.5k ★
Codenotch — A macOS app that pins usage limits from Claude Code, Cursor, Codex, and Antigravity to a screen edge 1.3k ★
Chops — 1,000+ macOS app to browse, edit, and manage skills across Claude Code, Cursor, Codex, Windsurf, and Amp 1.1k ★

README

Claude Cache Watch

A macOS App and local CLI that estimate the remaining prompt-cache TTL for Claude Code Desktop sessions. Both read only local files under `~/.claude`; they do not send prompts or call the Anthropic API.

Claude's prompt cache is server-side. The local JSONL records include cache read/write token counts, the cache TTL used (`5m` or `1h`), and event timestamps, but not a server-confirmed expiry timestamp. The CLI therefore reports a narrow estimate bounded by the local event immediately before the request and the first assistant event for that request.

Requirements

macOS 14 or later
Xcode Command Line Tools with Swift 5.10 or later
Python 3.10 or later
Claude Code Desktop with local session data under ~/.claude

macOS App

Build the App locally, then open the generated bundle:

./scripts/build-app.sh
open "dist/Claude Cache Watch.app"

Double-click the App to open the session window. The window provides:

one clear remaining-time value per monitored session;
inactive Desktop sessions remain visible while their latest cache may still be valid;
the latest model, a compact project path, and the latest instruction;
responsive session rows and text sizing based on both window width and height;
a compact bottom status bar with active-session count and controls;
a persistent window pin button that keeps the monitor above normal windows;
click a session row to activate Claude Code Desktop;
context menu actions to open the project folder or copy the session ID.

Claude Desktop's documented deep links can open a new Code session, but do not currently expose a route for opening an existing local Code session by session ID. For that reason, row clicks activate Claude Desktop without creating or resuming another session.

The App looks for Python in `CLAUDE_CACHE_WATCH_PYTHON`, `/opt/homebrew/bin/python3`, `/usr/local/bin/python3`, and `