Cachebell
Native sound and desktop reminders before an OpenCode prompt cache window ends
0
0
20.0
Multi-signal model
20 hours ago
2026-09-11
Install and configure
opencode.jsonWrites to this project's opencode.json — applies to this repository only.
opencode.json
{
"$schema": "https://opencode.ai/config.json",
"plugin": ["opencode-cachebell@0.2.0"]
}Writes to ~/.config/opencode/opencode.json — applies to every project.
~/.config/opencode/opencode.json
{
"$schema": "https://opencode.ai/config.json",
"plugin": ["opencode-cachebell@0.2.0"]
}If you want to modify the plugin locally, install it into the project and reference the local path.
shell
pnpm add -D opencode-cachebellOpenCode loads npm dependencies through its embedded runtime on startup and caches them locally — no manual global install needed.
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.2.0"]
}
Restart OpenCode. It installs the package automatically.
Supports macOS and WSL, with best-effort native Windows and Linux desktop support.
Sounds
Three original sounds are included:
| Sound | Style |
|---|---|
| Pulse (default) | Short, rising electronic signal |
| Chime | Two warm bell notes |
| Knock | Soft, woody double-tap |
To choose a sound, replace the plugin entry with:
{
"plugin": [["opencode-cachebell@0.2.0", { "sound": "chime" }]]
}
Use "pulse", "chime", "knock", or false for silence. Restart after changes.
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
Similar plugins
Smart Notify
opencode-smart-notify
Desktop notifications for OpenCode that stay quiet when auto-approve handles the request
Notification
opencode-notification
OpenCode plugin for simple system notifications when permissions are needed, generation completes, or errors occur
Sfx
opencode-sfx
OpenCode plugin that plays Warcraft-style sound effects for session events