TroubleshootingFix: OpenCode Interrupt Plugin Not Loading

Fix: OpenCode Interrupt Plugin Not Loading

Symptom: Plugin features not available. /ptt command not recognized. TTS not working. opencode plugin list shows errors.

Common Causes

⚠ 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.

Fallback

Check ~/.local/share/opencode/log/ for plugin-specific error messages. Search for "interrupt" in the most recent log file.

Still having trouble?

Contact support →