Troubleshooting › Fix: /ptt Command Not Working
Symptom: Typing /ptt in OpenCode does nothing, shows "unknown command" error, or fails silently.
⚠ Plugin not loaded
→ Run opencode plugin list. If interrupt is not listed, add "opencode-interrupt-plugin" to opencode.json and restart.
⚠ Plugin config hook failed
→ The plugin registers /ptt via the config hook. Check logs at ~/.local/share/opencode/log/ for errors during plugin initialization.
⚠ Old plugin cache
→ Delete the cache: rm -rf ~/.cache/opencode/packages/opencode-interrupt-plugin@latest. Then restart OpenCode.
⚠ Command conflict
→ Another plugin may have registered a "/ptt" command. Check all plugins in opencode.json for duplicate command registrations.
⚠ Session not active
→ Open a session first, then type /ptt. The command requires an active session context.
If /ptt still fails after troubleshooting, remove and re-add the plugin: delete the cache, remove from opencode.json, restart, add back, restart again.
Still having trouble?
Contact support →