Troubleshooting › Fix: OpenCode Interrupt Plugin Not Loading
Symptom: Plugin features not available. /ptt command not recognized. TTS not working. opencode plugin list shows errors.
⚠ Plugin not in opencode.json
→ Add "opencode-interrupt-plugin" to the plugins array in opencode.json (project root or ~/.config/opencode/opencode.json).
⚠ Stale npm cache
→ Delete the cached plugin: rm -rf ~/.cache/opencode/packages/opencode-interrupt-plugin@latest. Restart OpenCode to re-download.
⚠ Version mismatch
→ Ensure OpenCode v1.14+. Run opencode version to check. The plugin uses v1 plugin API hooks.
⚠ JSON syntax error
→ Validate your opencode.json: cat ~/.config/opencode/opencode.json | python3 -m json.tool. Fix any parse errors.
⚠ Plugin conflicts
→ If other plugins define the same hooks, conflicts can occur. Try removing other plugins temporarily to isolate.
Check ~/.local/share/opencode/log/ for plugin-specific error messages. Search for "interrupt" in the most recent log file.
Still having trouble?
Contact support →