Skip to content

Latest commit

 

History

9 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CacheBell

Get a reminder before your OpenCode prompt cache expires. Continuing the conversation while the cache is available means paying less for repeated input.

CacheBell plays a short sound and shows a desktop notification about two minutes beforehand, while the agent is idle.

Install

Add to plugin in ~/.config/opencode/opencode.json, keeping your other entries:

{
  "plugin": ["opencode-cachebell@0.5.0"]
}

Restart OpenCode. It installs the package automatically.

Works with OpenCode 1 and OpenCode 2 from the same package. Supports macOS and WSL, with best-effort native Windows and Linux desktop support.

Sounds

Nine sounds are included:

Sound Style
Pulse (default) Short, rising electronic signal
Chime Two warm bell notes
Knock Soft, woody double-tap
Sheep Field Quiet, 2.5-second field bleat
Sheep Close Quiet, 1.36-second close-up bleat
Cat Meow Short, soft meow
Rooster Crow Short farmyard crow
Horse Neigh Soft, short whinny
Cow Moo Soft, short moo

To choose a sound, replace the plugin entry with:

{
  "plugin": [["opencode-cachebell@0.5.0", { "sound": "sheep-close" }]]
}

Use "pulse", "chime", "knock", "sheep-field", "sheep-close", "cat-meow", "rooster-crow", "horse-neigh", "cow-moo", or false for silence. "sheep" remains an alias for "sheep-field". Restart after changes.

Sheep Field is an excerpt of a public-domain recording by earthcalling. Sheep Close is a CC0 recording by TheKingOfGeeks360, converted from its publicly available high-quality MP3 preview. Both are mono PCM WAVs for desktop playback. Cat Meow is an excerpt of a public-domain recording by Heismark. Rooster Crow is an excerpt of a public-domain recording by alys. Horse Neigh comes from a CC0 recording by Joseph Sardin. Cow Moo is excerpted from a CC0 recording by Joseph Sardin.

Timing

Defaults: 5 minutes for Claude, 30 minutes for GPT-5.6+. The clock starts with the model request, not when its answer finishes. Other models and custom cache durations need an override. These are estimates, not guaranteed cache hits.

Configuration and troubleshooting | npm | MIT

About

Native sound and desktop reminders before your OpenCode prompt cache window ends

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages