Guides › OpenCode Interrupt Plugin Configuration Guide
The interrupt plugin has several configuration options that control sensitivity, timing, and behavior. Free mode uses sensible defaults with a 20-interrupt/day cap. Pro mode ($29 one-time) unlocks unlimited interrupts, whisper model selection, TTS voice selection, and auto-language detection.
"opencode-interrupt-plugin" to opencode.json. No config needed. You get walkie-talkie (/ptt), streaming TTS, local whisper STT, and smart text cleaning — capped at 20 interrupts/day. The cap is tracked locally with a tamper-evident checksum file at ~/.cache/opencode/interrupt-count.json.[["opencode-interrupt-plugin", { "licenseKey": "INTERRUPT-..." }]]. Pro unlocks: unlimited interrupts, whisperModel selection (small/medium/large), ttsVoice pick, and auto-language detection.micThreshold: 0.015 — lower values detect quieter speech. Range 0.005–0.1. Default 0.02. Set too low and ambient noise triggers false positives.timingWindowMs: 5000 — how long after interruption to accept corrections. Range 1000–15000ms. Longer windows allow more time to formulate corrections.ttsVoice: "en-GB-SoniaNeural" to select any edge-tts neural voice. Free always uses the default. With auto-language (Pro), the plugin detects 18 languages from your text and switches TTS voice on the fly — speak French, hear French. TTS rate is configurable via ttsRate or EDGE_TTS_RATE env var.debug: true — logs every RMS reading, TTS start/end, interrupt cap checks, and injection decision. Essential for tuning.whisperModel: "small" — accepts base/small/medium/large or a full file path. Free forces base model regardless of config.Config changes require a restart. Check ~/.local/share/opencode/log/ for plugin load errors if changes are not picked up. If you hit the free cap (20/day), you will see a toast warning — the cap resets daily.
Ready to try it?
Get started free →