Herdr Plugin Done Timer — AI skill for Claude Code

herdr-plugin-done-timer

A prompt-cache countdown for every AI agent on herdr's agents panel, read from each agent's transcript.

[](LICENSE) [](https://herdr.dev)  

● nowalba-hq  t1
  claude  42:17        ← cache warm for another 42m 17s
● WAN  t1
  claude               ← answering right now: blank
● Boshy  t1
  codex   expired      ← last answer was more than an hour ago

Table of Contents

• Background
• Install
• Usage
• How it works
• Troubleshooting
• Limitations
• Acknowledgements
• Contributing
• License

Background

Claude Code caches your conversation prefix (1 hour on Pro/Max plans, 5 minutes with an API key). Replying while the cache is warm is fast and cheap; replying after it expires re-sends the whole context. With several agents running side by side in [herdr](https://herdr.dev), you cannot tell which ones are still warm.

`done-timer` shows it next to each agent in the sidebar:

• a countdown (59:59 → 00:00, every second) until the cache expires;
• expired once it has;
• nothing while the agent is answering, or when there is no conversation to cache.

The countdown is read from the agent's own session transcript, so it stays correct across herdr restarts and detaches.

Install

Requirements

• herdr 0.7.4 or newer (named sidebar tokens)
• bash, jq, perl on your PATH (all present on a stock macOS)

Steps

1. Install the plugin:

   herdr plugin install hanjm93/herdr-plugin-done-timer

2. Add the `$done` token to an agent row in `~/.